hackmyagent 0.8.1 → 0.9.0

package/dist/soul/scanner.d.ts

@@ -0,0 +1,95 @@
+/**
+ * SOUL Scanner - Behavioral Governance Scanner
+ *
+ * Scans governance files (SOUL.md, system-prompt.md, etc.) for coverage
+ * across 8 behavioral governance domains defined in OASB v2.
+ */
+export type AgentTier = 'BASIC' | 'TOOL-USING' | 'AGENTIC' | 'MULTI-AGENT';
+export type SoulGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+export interface ControlCheck {
+    id: string;
+    name: string;
+    domain: string;
+    keywords: string[];
+    passed: boolean;
+}
+export interface DomainResult {
+    domain: string;
+    domainId: number;
+    controls: ControlCheck[];
+    passed: number;
+    total: number;
+    percentage: number;
+}
+export interface SoulScanResult {
+    file: string | null;
+    fileSize: number;
+    agentTier: AgentTier;
+    domains: DomainResult[];
+    score: number;
+    grade: SoulGrade;
+    criticalFloor: boolean;
+    criticalMissing: string[];
+    totalControls: number;
+    totalPassed: number;
+}
+export interface HardenResult {
+    file: string;
+    sectionsAdded: string[];
+    controlsAdded: number;
+    dryRun: boolean;
+    content: string;
+    existedBefore: boolean;
+}
+declare const GOVERNANCE_FILES: string[];
+interface ControlDef {
+    id: string;
+    name: string;
+    domain: string;
+    domainId: number;
+    keywords: string[];
+    critical?: boolean;
+    /** Which tiers must satisfy this control. Empty means all tiers. */
+    tiers: AgentTier[];
+}
+declare const CONTROL_DEFS: ControlDef[];
+declare const DOMAIN_ORDER: string[];
+export declare class SoulScanner {
+    /**
+     * Find the governance file in a directory.
+     * Returns the first match from GOVERNANCE_FILES priority order, or null.
+     */
+    findGovernanceFile(targetDir: string): string | null;
+    /**
+     * Detect agent tier by scanning governance file content and project files.
+     */
+    detectTier(targetDir: string, governanceContent: string): AgentTier;
+    /**
+     * Check if content matches any keyword for a control.
+     * Case-insensitive substring match.
+     */
+    private checkControl;
+    /**
+     * Calculate grade from score, applying critical floor if needed.
+     */
+    private calculateGrade;
+    /**
+     * Return the subset of controls applicable to a given agent tier.
+     */
+    private applicableControls;
+    /**
+     * Scan a directory for behavioral governance coverage.
+     */
+    scanSoul(targetDir: string, options?: {
+        verbose?: boolean;
+        tier?: string;
+    }): Promise<SoulScanResult>;
+    /**
+     * Generate or update SOUL.md with missing governance sections.
+     */
+    hardenSoul(targetDir: string, options?: {
+        dryRun?: boolean;
+    }): Promise<HardenResult>;
+}
+export { CONTROL_DEFS, DOMAIN_ORDER, GOVERNANCE_FILES };
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/soul/scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;AAE3E,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD,QAAA,MAAM,gBAAgB,UAWrB,CAAC;AAMF,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAOD,QAAA,MAAM,YAAY,EAAE,UAAU,EAoE7B,CAAC;AAGF,QAAA,MAAM,YAAY,UASjB,CAAC;AAgBF,qBAAa,WAAW;IACtB;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUpD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS;IAiCnE;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAqG1G;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CA6E3F;AAGD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/soul/scanner.js

@@ -0,0 +1,411 @@
+"use strict";
+/**
+ * SOUL Scanner - Behavioral Governance Scanner
+ *
+ * Scans governance files (SOUL.md, system-prompt.md, etc.) for coverage
+ * across 8 behavioral governance domains defined in OASB v2.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOVERNANCE_FILES = exports.DOMAIN_ORDER = exports.CONTROL_DEFS = exports.SoulScanner = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const templates_1 = require("./templates");
+// ---------------------------------------------------------------------------
+// Governance file search order
+// ---------------------------------------------------------------------------
+const GOVERNANCE_FILES = [
+    'SOUL.md',
+    'system-prompt.md',
+    'SYSTEM_PROMPT.md',
+    '.cursorrules',
+    '.github/copilot-instructions.md',
+    'CLAUDE.md',
+    '.clinerules',
+    'instructions.md',
+    'constitution.md',
+    'agent-config.yaml',
+];
+exports.GOVERNANCE_FILES = GOVERNANCE_FILES;
+const ALL_TIERS = ['BASIC', 'TOOL-USING', 'AGENTIC', 'MULTI-AGENT'];
+const TOOL_AND_UP = ['TOOL-USING', 'AGENTIC', 'MULTI-AGENT'];
+const AGENTIC_AND_UP = ['AGENTIC', 'MULTI-AGENT'];
+const MULTI_AGENT_ONLY = ['MULTI-AGENT'];
+const CONTROL_DEFS = [
+    // Domain 7: Trust Hierarchy
+    { id: 'SOUL-TH-001', name: 'Trust chain defined', domain: 'Trust Hierarchy', domainId: 7, tiers: ALL_TIERS,
+        keywords: ['trust', 'authority', 'principal', 'hierarchy', 'precedence', 'priority'] },
+    { id: 'SOUL-TH-002', name: 'Conflict resolution defined', domain: 'Trust Hierarchy', domainId: 7, tiers: ALL_TIERS,
+        keywords: ['conflict', 'override', 'precedence', 'escalat'] },
+    { id: 'SOUL-TH-003', name: 'Agent-to-agent trust', domain: 'Trust Hierarchy', domainId: 7, tiers: MULTI_AGENT_ONLY,
+        keywords: ['agent-to-agent', 'sub-agent', 'orchestrat', 'delegate', 'trust.*agent', 'agent.*trust'] },
+    // Domain 8: Capability Boundaries (TOOL-USING and up)
+    { id: 'SOUL-CB-001', name: 'Allowed actions declared', domain: 'Capability Boundaries', domainId: 8, tiers: TOOL_AND_UP,
+        keywords: ['allow', 'permit', 'can do', 'authorized', 'capabilities'] },
+    { id: 'SOUL-CB-002', name: 'Denied actions declared', domain: 'Capability Boundaries', domainId: 8, tiers: TOOL_AND_UP,
+        keywords: ['deny', 'prohibit', 'must not', 'cannot', 'forbidden', 'restricted'] },
+    { id: 'SOUL-CB-003', name: 'Filesystem/network scope', domain: 'Capability Boundaries', domainId: 8, tiers: TOOL_AND_UP,
+        keywords: ['file', 'directory', 'path', 'network', 'endpoint', 'url', 'api'] },
+    { id: 'SOUL-CB-004', name: 'Least privilege principle', domain: 'Capability Boundaries', domainId: 8, tiers: TOOL_AND_UP,
+        keywords: ['least privilege', 'minimal', 'only needed', 'minimum necessary'] },
+    // Domain 9: Injection Hardening (all tiers)
+    { id: 'SOUL-IH-001', name: 'Instruction override defense', domain: 'Injection Hardening', domainId: 9, tiers: ALL_TIERS,
+        keywords: ['ignore previous', 'override', 'injection', 'contradict'] },
+    { id: 'SOUL-IH-002', name: 'Encoded payload defense', domain: 'Injection Hardening', domainId: 9, tiers: ALL_TIERS,
+        keywords: ['encoded', 'obfuscated', 'base64', 'hidden'] },
+    { id: 'SOUL-IH-003', name: 'Role-play refusal', domain: 'Injection Hardening', domainId: 9, tiers: ALL_TIERS,
+        keywords: ['role-play', 'pretend', 'act as', 'jailbreak', 'DAN'], critical: true },
+    // Domain 10: Data Handling
+    { id: 'SOUL-DH-001', name: 'PII protection', domain: 'Data Handling', domainId: 10, tiers: ALL_TIERS,
+        keywords: ['pii', 'personal', 'privacy', 'data protection', 'gdpr'] },
+    { id: 'SOUL-DH-002', name: 'Credential handling', domain: 'Data Handling', domainId: 10, tiers: TOOL_AND_UP,
+        keywords: ['credential', 'secret', 'password', 'api key', 'token'] },
+    { id: 'SOUL-DH-003', name: 'Data minimization', domain: 'Data Handling', domainId: 10, tiers: ALL_TIERS,
+        keywords: ['minimiz', 'only collect', 'retention', 'delete', 'purge'] },
+    // Domain 11: Hardcoded Behaviors (all tiers)
+    { id: 'SOUL-HB-001', name: 'Safety immutables defined', domain: 'Hardcoded Behaviors', domainId: 11, tiers: ALL_TIERS,
+        keywords: ['never', 'always', 'must not', 'absolute', 'immutable', 'hardcoded'], critical: true },
+    { id: 'SOUL-HB-002', name: 'No data exfiltration rule', domain: 'Hardcoded Behaviors', domainId: 11, tiers: ALL_TIERS,
+        keywords: ['exfiltrat', 'unauthorized', 'leak', 'transmit'] },
+    { id: 'SOUL-HB-003', name: 'Kill switch / emergency stop', domain: 'Hardcoded Behaviors', domainId: 11, tiers: ALL_TIERS,
+        keywords: ['kill switch', 'emergency', 'shutdown', 'terminate', 'stop'] },
+    // Domain 12: Agentic Safety (AGENTIC and up)
+    { id: 'SOUL-AS-001', name: 'Iteration/loop limits', domain: 'Agentic Safety', domainId: 12, tiers: AGENTIC_AND_UP,
+        keywords: ['iteration', 'loop', 'limit', 'maximum', 'budget'] },
+    { id: 'SOUL-AS-002', name: 'Budget/cost caps', domain: 'Agentic Safety', domainId: 12, tiers: AGENTIC_AND_UP,
+        keywords: ['budget', 'cost', 'spending', 'cap', 'limit'] },
+    { id: 'SOUL-AS-003', name: 'Timeout defined', domain: 'Agentic Safety', domainId: 12, tiers: AGENTIC_AND_UP,
+        keywords: ['timeout', 'time limit', 'duration', 'deadline'] },
+    { id: 'SOUL-AS-004', name: 'Reversibility preference', domain: 'Agentic Safety', domainId: 12, tiers: MULTI_AGENT_ONLY,
+        keywords: ['reversible', 'undo', 'rollback', 'revert'] },
+    // Domain 13: Honesty and Transparency (all tiers)
+    { id: 'SOUL-HT-001', name: 'Uncertainty acknowledgment', domain: 'Honesty and Transparency', domainId: 13, tiers: ALL_TIERS,
+        keywords: ['uncertain', "don't know", 'not sure', 'acknowledge', 'calibrat'] },
+    { id: 'SOUL-HT-002', name: 'No fabrication rule', domain: 'Honesty and Transparency', domainId: 13, tiers: ALL_TIERS,
+        keywords: ['fabricat', 'hallucin', 'invent', 'make up', 'accurate'] },
+    { id: 'SOUL-HT-003', name: 'Identity disclosure', domain: 'Honesty and Transparency', domainId: 13, tiers: ALL_TIERS,
+        keywords: ['identity', 'ai', 'assistant', 'disclose', 'transparent'] },
+    // Domain 14: Human Oversight (TOOL-USING and up)
+    { id: 'SOUL-HO-001', name: 'Approval gates', domain: 'Human Oversight', domainId: 14, tiers: TOOL_AND_UP,
+        keywords: ['approval', 'confirm', 'human-in-the-loop', 'review', 'authorize'] },
+    { id: 'SOUL-HO-002', name: 'Override mechanism', domain: 'Human Oversight', domainId: 14, tiers: TOOL_AND_UP,
+        keywords: ['override', 'intervene', 'manual', 'human control'] },
+    { id: 'SOUL-HO-003', name: 'Monitoring/logging', domain: 'Human Oversight', domainId: 14, tiers: TOOL_AND_UP,
+        keywords: ['monitor', 'log', 'audit', 'track', 'observe'] },
+];
+exports.CONTROL_DEFS = CONTROL_DEFS;
+// Unique domain names in order
+const DOMAIN_ORDER = [
+    'Trust Hierarchy',
+    'Capability Boundaries',
+    'Injection Hardening',
+    'Data Handling',
+    'Hardcoded Behaviors',
+    'Agentic Safety',
+    'Honesty and Transparency',
+    'Human Oversight',
+];
+exports.DOMAIN_ORDER = DOMAIN_ORDER;
+// ---------------------------------------------------------------------------
+// Tier detection keywords
+// ---------------------------------------------------------------------------
+const TIER_KEYWORDS = {
+    multiAgent: ['orchestrat', 'delegate', 'sub-agent', 'sub_agent', 'multi-agent', 'multi_agent', 'swarm', 'coordinator'],
+    agentic: ['autonomous', 'loop', 'iterate', 'self-directed', 'agent loop', 'auto-run', 'agentic'],
+    toolUsing: ['tool_use', 'function_calling', 'tools', 'mcp', 'modelcontextprotocol', 'function call', 'tool call'],
+};
+// ---------------------------------------------------------------------------
+// SoulScanner class
+// ---------------------------------------------------------------------------
+class SoulScanner {
+    /**
+     * Find the governance file in a directory.
+     * Returns the first match from GOVERNANCE_FILES priority order, or null.
+     */
+    findGovernanceFile(targetDir) {
+        for (const filename of GOVERNANCE_FILES) {
+            const fullPath = path.join(targetDir, filename);
+            if (fs.existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+        return null;
+    }
+    /**
+     * Detect agent tier by scanning governance file content and project files.
+     */
+    detectTier(targetDir, governanceContent) {
+        // Combine governance content with any package.json or config content
+        let combined = governanceContent.toLowerCase();
+        const pkgPath = path.join(targetDir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                combined += ' ' + fs.readFileSync(pkgPath, 'utf-8').toLowerCase();
+            }
+            catch {
+                // ignore read errors
+            }
+        }
+        // Check in order from most capable to least
+        for (const kw of TIER_KEYWORDS.multiAgent) {
+            if (combined.includes(kw.toLowerCase())) {
+                return 'MULTI-AGENT';
+            }
+        }
+        for (const kw of TIER_KEYWORDS.agentic) {
+            if (combined.includes(kw.toLowerCase())) {
+                return 'AGENTIC';
+            }
+        }
+        for (const kw of TIER_KEYWORDS.toolUsing) {
+            if (combined.includes(kw.toLowerCase())) {
+                return 'TOOL-USING';
+            }
+        }
+        return 'BASIC';
+    }
+    /**
+     * Check if content matches any keyword for a control.
+     * Case-insensitive substring match.
+     */
+    checkControl(content, def) {
+        const lower = content.toLowerCase();
+        for (const kw of def.keywords) {
+            if (lower.includes(kw.toLowerCase())) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Calculate grade from score, applying critical floor if needed.
+     */
+    calculateGrade(score, criticalMissing) {
+        let grade;
+        if (score >= 80)
+            grade = 'A';
+        else if (score >= 60)
+            grade = 'B';
+        else if (score >= 40)
+            grade = 'C';
+        else if (score >= 20)
+            grade = 'D';
+        else
+            grade = 'F';
+        // Critical floor: if critical controls are missing, cap at C
+        if (criticalMissing.length > 0 && (grade === 'A' || grade === 'B')) {
+            return { grade: 'C', floored: true };
+        }
+        return { grade, floored: false };
+    }
+    /**
+     * Return the subset of controls applicable to a given agent tier.
+     */
+    applicableControls(tier) {
+        return CONTROL_DEFS.filter((d) => d.tiers.includes(tier));
+    }
+    /**
+     * Scan a directory for behavioral governance coverage.
+     */
+    async scanSoul(targetDir, options) {
+        const govFile = this.findGovernanceFile(targetDir);
+        // Detect tier early (needed for applicable control count)
+        const contentForTier = govFile ? (() => { try {
+            return fs.readFileSync(govFile, 'utf-8');
+        }
+        catch {
+            return '';
+        } })() : '';
+        const tier = options?.tier || this.detectTier(targetDir, contentForTier);
+        const applicable = this.applicableControls(tier);
+        // No governance file found
+        if (!govFile) {
+            const emptyDomains = DOMAIN_ORDER.map((domain) => {
+                const defs = applicable.filter((d) => d.domain === domain);
+                if (defs.length === 0)
+                    return null; // Domain not applicable for this tier
+                const controls = defs
+                    .map((d) => ({ id: d.id, name: d.name, domain: d.domain, keywords: d.keywords, passed: false }));
+                const domainId = defs[0]?.domainId ?? 0;
+                return {
+                    domain,
+                    domainId,
+                    controls,
+                    passed: 0,
+                    total: controls.length,
+                    percentage: 0,
+                };
+            }).filter((d) => d !== null);
+            const criticalMissing = applicable.filter((d) => d.critical).map((d) => d.id);
+            const { grade, floored } = this.calculateGrade(0, criticalMissing);
+            return {
+                file: null,
+                fileSize: 0,
+                agentTier: tier,
+                domains: emptyDomains,
+                score: 0,
+                grade,
+                criticalFloor: floored,
+                criticalMissing,
+                totalControls: applicable.length,
+                totalPassed: 0,
+            };
+        }
+        // Read governance file
+        const content = contentForTier;
+        const fileSize = Buffer.byteLength(content, 'utf-8');
+        // Check each applicable control
+        const controlResults = applicable.map((def) => ({
+            id: def.id,
+            name: def.name,
+            domain: def.domain,
+            keywords: def.keywords,
+            passed: this.checkControl(content, def),
+        }));
+        // Group into domains (only domains with applicable controls)
+        const domains = DOMAIN_ORDER.map((domain) => {
+            const domainControls = controlResults.filter((c) => c.domain === domain);
+            if (domainControls.length === 0)
+                return null; // No applicable controls for this tier
+            const passed = domainControls.filter((c) => c.passed).length;
+            const total = domainControls.length;
+            const domainId = CONTROL_DEFS.find((d) => d.domain === domain)?.domainId ?? 0;
+            return {
+                domain,
+                domainId,
+                controls: domainControls,
+                passed,
+                total,
+                percentage: total > 0 ? Math.round((passed / total) * 100) : 0,
+            };
+        }).filter((d) => d !== null);
+        // Calculate overall score as average of applicable domain percentages
+        const score = domains.length > 0
+            ? Math.round(domains.reduce((sum, d) => sum + d.percentage, 0) / domains.length)
+            : 0;
+        // Find missing critical controls (only applicable ones)
+        const criticalMissing = applicable
+            .filter((d) => d.critical)
+            .filter((d) => !controlResults.find((c) => c.id === d.id)?.passed)
+            .map((d) => d.id);
+        const { grade, floored } = this.calculateGrade(score, criticalMissing);
+        const totalPassed = controlResults.filter((c) => c.passed).length;
+        return {
+            file: path.relative(targetDir, govFile) || path.basename(govFile),
+            fileSize,
+            agentTier: tier,
+            domains,
+            score,
+            grade,
+            criticalFloor: floored,
+            criticalMissing,
+            totalControls: applicable.length,
+            totalPassed,
+        };
+    }
+    /**
+     * Generate or update SOUL.md with missing governance sections.
+     */
+    async hardenSoul(targetDir, options) {
+        const dryRun = options?.dryRun ?? false;
+        // Run scan to find what is missing
+        const scanResult = await this.scanSoul(targetDir);
+        // Determine target file
+        const govFile = scanResult.file
+            ? path.join(targetDir, scanResult.file)
+            : path.join(targetDir, 'SOUL.md');
+        const existedBefore = scanResult.file !== null;
+        const sectionsAdded = [];
+        let controlsAdded = 0;
+        // Build content to append
+        let newContent = '';
+        if (!existedBefore) {
+            // Create full SOUL.md from scratch
+            newContent += `# Agent Governance (SOUL)\n\nThis document defines the behavioral governance rules for this agent.\nGenerated by HackMyAgent scan-soul/harden-soul.\n\n`;
+        }
+        // Read existing content to avoid duplicating sections
+        let existingContent = '';
+        if (existedBefore) {
+            try {
+                existingContent = fs.readFileSync(govFile, 'utf-8');
+            }
+            catch {
+                // File may not be readable; treat as empty
+            }
+        }
+        // harden-soul generates all 8 domain sections (comprehensive / future-proof).
+        // scan-soul evaluates only tier-applicable controls; harden-soul adds them all
+        // so the resulting SOUL.md is ready if the agent tier increases later.
+        for (const domainName of DOMAIN_ORDER) {
+            const template = templates_1.DOMAIN_TEMPLATES[domainName];
+            if (!template)
+                continue;
+            // Check if the heading already exists in the file
+            const existingLower = existingContent.toLowerCase();
+            const headingLower = template.heading.toLowerCase();
+            if (existingLower.includes(headingLower)) {
+                // Domain heading exists -- skip to avoid overwriting user content.
+                continue;
+            }
+            newContent += template.content + '\n';
+            sectionsAdded.push(domainName);
+            // Count controls in this domain (all tiers, since we're adding comprehensive content)
+            const domainControls = CONTROL_DEFS.filter((d) => d.domain === domainName).length;
+            controlsAdded += domainControls;
+        }
+        // Apply or preview
+        if (!dryRun && newContent.length > 0) {
+            if (existedBefore) {
+                // Append to existing file
+                fs.appendFileSync(govFile, '\n' + newContent);
+            }
+            else {
+                // Create new file
+                fs.writeFileSync(govFile, newContent);
+            }
+        }
+        const outputFile = path.relative(targetDir, govFile) || path.basename(govFile);
+        return {
+            file: outputFile,
+            sectionsAdded,
+            controlsAdded,
+            dryRun,
+            content: newContent,
+            existedBefore,
+        };
+    }
+}
+exports.SoulScanner = SoulScanner;
+//# sourceMappingURL=scanner.js.map

package/dist/soul/scanner.js.map

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

package/dist/soul/templates.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SOUL.md governance templates for each domain.
+ * Used by harden-soul to generate missing governance sections.
+ */
+export interface DomainTemplate {
+    domainId: number;
+    domainName: string;
+    heading: string;
+    content: string;
+}
+export declare const DOMAIN_TEMPLATES: Record<string, DomainTemplate>;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/soul/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA0M3D,CAAC"}