hackmyagent 0.9.3 → 0.9.5

package/dist/soul/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/soul/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAAsF;AAA7E,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AASlE,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/soul/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAAuG;AAA9F,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAWnF,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA"}

package/dist/soul/scanner.d.ts

@@ -6,7 +6,11 @@
  */
 export type AgentTier = 'BASIC' | 'TOOL-USING' | 'AGENTIC' | 'MULTI-AGENT';
 export type SoulGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+/** Progress-oriented maturity level (replaces punitive letter grades in display). */
+export type SoulLevel = 'hardened' | 'standard' | 'developing' | 'initial' | 'not-started';
 export type ConformanceLevel = 'none' | 'essential' | 'standard' | 'hardened';
+/** Agent profile determines which governance domains are relevant. */
+export type AgentProfile = 'conversational' | 'code-assistant' | 'tool-agent' | 'autonomous' | 'orchestrator' | 'custom';
 export interface ControlCheck {
     id: string;
     name: string;
@@ -21,6 +25,8 @@ export interface DomainResult {
     passed: number;
     total: number;
     percentage: number;
+    /** True when this domain was skipped due to agent profile filtering. */
+    skippedByProfile?: boolean;
 }
 export interface DeepAnalysisEntry {
     controlId: string;
@@ -31,15 +37,25 @@ export interface SoulScanResult {
     file: string | null;
     fileSize: number;
     agentTier: AgentTier;
+    tierForced: boolean;
+    /** Detected or forced agent profile. */
+    agentProfile: AgentProfile;
+    profileForced: boolean;
+    /** Domain IDs skipped due to profile filtering. */
+    skippedDomains: string[];
     domains: DomainResult[];
     score: number;
+    /** @deprecated Use `level` instead. Kept for backward compatibility. */
     grade: SoulGrade;
+    /** Progress-oriented maturity level. */
+    level: SoulLevel;
     conformance: ConformanceLevel;
     criticalFloor: boolean;
     criticalMissing: string[];
     totalControls: number;
     totalPassed: number;
     deepAnalysisResults?: DeepAnalysisEntry[];
+    deepAnalysisAvailable?: boolean;
 }
 export interface HardenResult {
     file: string;
@@ -59,9 +75,13 @@ interface ControlDef {
     critical?: boolean;
     /** Which tiers must satisfy this control. Empty means all tiers. */
     tiers: AgentTier[];
+    /** Short remediation text that naturally contains the control's keywords. */
+    remediation?: string;
 }
 declare const CONTROL_DEFS: ControlDef[];
 declare const DOMAIN_ORDER: string[];
+/** Domain IDs that apply to each profile. */
+declare const PROFILE_DOMAINS: Record<AgentProfile, number[]>;
 export declare class SoulScanner {
     /**
      * Find the governance file in a directory.
@@ -70,23 +90,35 @@ export declare class SoulScanner {
     findGovernanceFile(targetDir: string): string | null;
     /**
      * Detect agent tier by scanning governance file content and project files.
+     * Respects a `<!-- soul:tier=TIER -->` marker if present (prevents tier drift).
      */
     detectTier(targetDir: string, governanceContent: string): AgentTier;
+    /**
+     * Detect agent profile from governance content.
+     * Respects a `<!-- soul:profile=PROFILE -->` marker if present.
+     */
+    detectProfile(governanceContent: string): AgentProfile;
     /**
      * Check if content matches any keyword for a control.
      * Case-insensitive substring match.
      */
-    private checkControl;
+    checkControl(content: string, def: ControlDef): boolean;
     /**
      * LLM-powered semantic analysis for a single control.
      * Uses claude CLI first, falls back to Anthropic API.
      * Returns true if the LLM determines the content addresses the control.
      */
+    private isLlmAvailable;
     private analyzeControlDeep;
     /**
      * Calculate grade from score, applying critical floor if needed.
+     * @deprecated Use calculateLevel() for display; grade kept for backward compat.
      */
     private calculateGrade;
+    /**
+     * Calculate progress-oriented maturity level.
+     */
+    private calculateLevel;
     /**
      * Calculate conformance level based on score and critical control status.
      * none:      one or more critical controls are missing
@@ -96,7 +128,7 @@ export declare class SoulScanner {
      */
     private calculateConformance;
     /**
-     * Return the subset of controls applicable to a given agent tier.
+     * Return the subset of controls applicable to a given agent tier and profile.
      */
     private applicableControls;
     /**
@@ -105,14 +137,18 @@ export declare class SoulScanner {
     scanSoul(targetDir: string, options?: {
         verbose?: boolean;
         tier?: string;
+        profile?: string;
         deepAnalysis?: boolean;
     }): Promise<SoulScanResult>;
     /**
      * Generate or update SOUL.md with missing governance sections.
+     * Supports iterative hardening: if a domain heading exists but controls
+     * are failing, appends targeted remediation for those controls.
      */
     hardenSoul(targetDir: string, options?: {
         dryRun?: boolean;
+        profile?: string;
     }): Promise<HardenResult>;
 }
-export { CONTROL_DEFS, DOMAIN_ORDER, GOVERNANCE_FILES };
+export { CONTROL_DEFS, DOMAIN_ORDER, GOVERNANCE_FILES, PROFILE_DOMAINS };
 //# sourceMappingURL=scanner.d.ts.map

package/dist/soul/scanner.d.ts.map

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