faf-cli 3.1.6 → 3.2.0

package/dist/commands/check.js

@@ -1,58 +1,301 @@
 "use strict";
 /**
- * 🔍 Check Command - Merged audit + validate functionality
- * Comprehensive .faf file validation and freshness checking
+ * 🔍 Check Command - Quality inspection & protection system
+ * Pre-flight inspection for human_context quality + field protection
+ *
+ * Features:
+ * - Quality detection: empty/generic/good/excellent per field
+ * - Protection system: lock good content from being overwritten
+ * - Integration with faf auto to respect protected fields
  */
+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.checkCommand = checkCommand;
+exports.isFieldProtected = isFieldProtected;
+exports.getProtectedFields = getProtectedFields;
 const validate_1 = require("./validate");
 const audit_1 = require("./audit");
 const championship_style_1 = require("../utils/championship-style");
+const file_utils_1 = require("../utils/file-utils");
+const yaml_1 = require("../fix-once/yaml");
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+// Generic values that indicate low quality
+const GENERIC_PATTERNS = [
+    /^unknown$/i,
+    /^none$/i,
+    /^n\/a$/i,
+    /^todo$/i,
+    /^tbd$/i,
+    /^placeholder$/i,
+    /^fill this/i,
+    /^add your/i,
+    /^describe/i,
+    /^your project/i,
+    /^my project/i,
+    /^\[.*\]$/, // [bracketed placeholders]
+    /^<.*>$/, // <angle bracket placeholders>
+];
+// Quality scoring criteria per field
+const QUALITY_CRITERIA = {
+    who: {
+        minLength: 10,
+        excellentPatterns: [/team|company|developer|engineer|community/i]
+    },
+    what: {
+        minLength: 20,
+        excellentPatterns: [/that|which|for|enables|provides/i]
+    },
+    why: {
+        minLength: 15,
+        excellentPatterns: [/faster|better|easier|simpler|efficient|\d+x/i]
+    },
+    where: {
+        minLength: 8,
+        excellentPatterns: [/browser|server|edge|cloud|local|npm|cargo/i]
+    },
+    when: {
+        minLength: 5,
+        excellentPatterns: [/v\d|version|\d{4}|release|milestone/i]
+    },
+    how: {
+        minLength: 5,
+        excellentPatterns: [/npm|cargo|pip|run|install|clone|demo/i]
+    },
+};
+/**
+ * Assess quality of a single field value
+ */
+function assessFieldQuality(field, value) {
+    // Empty check
+    if (!value || value.trim() === '') {
+        return 'empty';
+    }
+    const trimmed = value.trim();
+    // Generic check
+    for (const pattern of GENERIC_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return 'generic';
+        }
+    }
+    const criteria = QUALITY_CRITERIA[field] || { minLength: 10 };
+    // Length check for good
+    if (trimmed.length < criteria.minLength) {
+        return 'generic';
+    }
+    // Excellent check
+    if (criteria.excellentPatterns) {
+        for (const pattern of criteria.excellentPatterns) {
+            if (pattern.test(trimmed)) {
+                return 'excellent';
+            }
+        }
+    }
+    return 'good';
+}
 /**
- * Comprehensive check command - combines validation and audit
+ * Get quality indicator emoji
+ */
+function getQualityIndicator(quality) {
+    switch (quality) {
+        case 'empty': return '⬜'; // Empty slot
+        case 'generic': return '🟡'; // Needs improvement
+        case 'good': return '🟢'; // Good quality
+        case 'excellent': return '💎'; // Excellent
+    }
+}
+/**
+ * Get protection status indicator
+ */
+function getProtectionIndicator(isProtected) {
+    return isProtected ? '🔒' : '  ';
+}
+/**
+ * Inspect human_context quality and optionally protect fields
  */
 async function checkCommand(options = {}) {
     try {
         const startTime = Date.now();
-        console.log(championship_style_1.FAF_COLORS.fafCyan(`${championship_style_1.FAF_ICONS.magnifying_glass} Comprehensive .faf Check`));
-        // If no specific options, do both format and freshness checks
-        const checkFormat = options.format || (!options.fresh && !options.format);
-        const checkFreshness = options.fresh || (!options.fresh && !options.format);
-        let hasErrors = false;
-        if (checkFormat) {
-            console.log(`${championship_style_1.FAF_COLORS.fafCyan('├─ ')}Checking format and validity...`);
-            try {
-                // Call validate with proper parameters
-                await (0, validate_1.validateFafFile)(undefined, {
-                    verbose: options.detailed
-                });
-            }
-            catch {
-                hasErrors = true;
-            }
-        }
-        if (checkFreshness) {
-            console.log(`${championship_style_1.FAF_COLORS.fafCyan('├─ ')}Checking freshness and completeness...`);
-            try {
-                // Call audit with proper parameters
-                await (0, audit_1.auditFafFile)(undefined, {
-                // AuditOptions doesn't have detailed, use defaults
-                });
-            }
-            catch {
-                hasErrors = true;
-            }
-        }
-        const duration = Date.now() - startTime;
-        if (!hasErrors) {
+        // Find and load the .faf file
+        const fafPath = await (0, file_utils_1.findFafFile)(process.cwd());
+        if (!fafPath) {
+            console.error(championship_style_1.FAF_COLORS.fafOrange('❌ No .faf file found. Run: faf init'));
+            process.exit(1);
+        }
+        const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(fafContent) || {};
+        const humanContext = fafData.human_context || {};
+        const protectedFields = fafData._protected_fields || [];
+        // The 6 Ws to check
+        const fields = ['who', 'what', 'why', 'where', 'when', 'how'];
+        // Assess quality of each field
+        const fieldQualities = fields.map(field => ({
+            field,
+            value: humanContext[field] || null,
+            quality: assessFieldQuality(field, humanContext[field]),
+            protected: protectedFields.includes(field),
+        }));
+        // Handle --unlock: remove all protections
+        if (options.unlock) {
+            fafData._protected_fields = [];
+            await fs_1.promises.writeFile(fafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`🔓 All fields unlocked`));
+            console.log(`   Protected fields cleared from ${path.basename(fafPath)}`);
+            return;
+        }
+        // Handle --protect: auto-protect good/excellent fields
+        if (options.protect) {
+            const toProtect = fieldQualities
+                .filter(f => f.quality === 'good' || f.quality === 'excellent')
+                .map(f => f.field);
+            if (toProtect.length === 0) {
+                console.log(championship_style_1.FAF_COLORS.fafOrange('⚠️ No fields qualify for protection (need good or excellent quality)'));
+                return;
+            }
+            // Merge with existing protected fields
+            const newProtected = [...new Set([...protectedFields, ...toProtect])];
+            fafData._protected_fields = newProtected;
+            await fs_1.promises.writeFile(fafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+            console.log(championship_style_1.FAF_COLORS.fafGreen(`🔒 Protected ${toProtect.length} field(s):`));
+            for (const field of toProtect) {
+                const q = fieldQualities.find(f => f.field === field);
+                console.log(`   ${getQualityIndicator(q?.quality || 'good')} ${field}`);
+            }
             console.log();
-            console.log(championship_style_1.FAF_COLORS.fafGreen(`${championship_style_1.FAF_ICONS.trophy} All checks passed in ${duration}ms!`));
-            console.log(`${championship_style_1.FAF_COLORS.fafCyan(`${championship_style_1.FAF_ICONS.magic_wand} Try: `)}faf score${championship_style_1.FAF_COLORS.fafCyan(' - See your completeness score')}`);
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`💡 Protected fields won't be overwritten by faf auto or faf readme`));
+            return;
+        }
+        // Default behavior: show quality inspection
+        if (!options.quiet) {
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`${championship_style_1.FAF_ICONS.magnifying_glass} Human Context Quality Check`));
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`   ${path.basename(fafPath)}`));
+            console.log();
+        }
+        // Count by quality level
+        const counts = {
+            empty: 0,
+            generic: 0,
+            good: 0,
+            excellent: 0,
+        };
+        // Display each field
+        for (const fq of fieldQualities) {
+            counts[fq.quality]++;
+            const indicator = getQualityIndicator(fq.quality);
+            const lockIcon = getProtectionIndicator(fq.protected);
+            const displayValue = fq.value
+                ? (fq.value.length > 50 ? fq.value.substring(0, 47) + '...' : fq.value)
+                : '(empty)';
+            if (!options.quiet) {
+                console.log(`   ${indicator} ${lockIcon} ${fq.field.toUpperCase().padEnd(6)} ${championship_style_1.FAF_COLORS.fafCyan(displayValue)}`);
+            }
+        }
+        if (!options.quiet) {
+            console.log();
+            // Summary
+            const total = fields.length;
+            const qualityScore = Math.round(((counts.excellent * 1.0 + counts.good * 0.75 + counts.generic * 0.25) / total) * 100);
+            console.log(`   📊 Quality: ${qualityScore}%`);
+            console.log(`   💎 Excellent: ${counts.excellent}  🟢 Good: ${counts.good}  🟡 Generic: ${counts.generic}  ⬜ Empty: ${counts.empty}`);
+            if (protectedFields.length > 0) {
+                console.log(`   🔒 Protected: ${protectedFields.join(', ')}`);
+            }
+            console.log();
+            // Suggestions
+            if (counts.empty > 0 || counts.generic > 0) {
+                console.log(championship_style_1.FAF_COLORS.fafOrange('   💡 Improve with:'));
+                if (counts.empty > 0) {
+                    console.log(`      faf readme --apply   (auto-extract from README)`);
+                    console.log(`      faf human-set <field> "<value>"   (manual)`);
+                }
+                if (counts.generic > 0) {
+                    console.log(`      faf readme --apply --force   (overwrite generic)`);
+                }
+            }
+            if (counts.good > 0 || counts.excellent > 0) {
+                const unprotectedGood = fieldQualities.filter(f => (f.quality === 'good' || f.quality === 'excellent') && !f.protected).length;
+                if (unprotectedGood > 0) {
+                    console.log(championship_style_1.FAF_COLORS.fafGreen(`   🔒 Lock good content:`));
+                    console.log(`      faf check --protect   (auto-protect good/excellent)`);
+                }
+            }
+            const duration = Date.now() - startTime;
+            console.log();
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`   ⚡ ${duration}ms`));
+        }
+        // Also run original format/freshness checks if requested
+        if (options.format || options.fresh) {
+            console.log();
+            if (options.format) {
+                console.log(`${championship_style_1.FAF_COLORS.fafCyan('├─ ')}Checking format and validity...`);
+                try {
+                    await (0, validate_1.validateFafFile)(undefined, {
+                        verbose: options.detailed
+                    });
+                }
+                catch {
+                    // Continue
+                }
+            }
+            if (options.fresh) {
+                console.log(`${championship_style_1.FAF_COLORS.fafCyan('├─ ')}Checking freshness and completeness...`);
+                try {
+                    await (0, audit_1.auditFafFile)(undefined, {});
+                }
+                catch {
+                    // Continue
+                }
+            }
         }
     }
     catch (error) {
-        console.error(championship_style_1.FAF_COLORS.fafOrange(`${championship_style_1.FAF_ICONS.shield} Check failed: ${error instanceof Error ? error.message : String(error)}`));
+        console.error(championship_style_1.FAF_COLORS.fafOrange(`❌ Check failed: ${error instanceof Error ? error.message : String(error)}`));
         process.exit(1);
     }
 }
+/**
+ * Check if a field is protected
+ */
+function isFieldProtected(fafData, field) {
+    const protectedFields = fafData._protected_fields || [];
+    return protectedFields.includes(field);
+}
+/**
+ * Get all protected fields
+ */
+function getProtectedFields(fafData) {
+    return fafData._protected_fields || [];
+}
 //# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAmBH,oCAgDC;AAjED,yCAA6C;AAC7C,mCAAuC;AACvC,oEAGqC;AASrC;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IAClE,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,+BAAU,CAAC,OAAO,CAAC,GAAG,8BAAS,CAAC,gBAAgB,2BAA2B,CAAC,CAAC,CAAC;QAE1F,8DAA8D;QAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1E,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE5E,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,GAAG,+BAAU,CAAC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAC3E,IAAI,CAAC;gBACH,uCAAuC;gBACvC,MAAM,IAAA,0BAAe,EAAC,SAAS,EAAE;oBAC/B,OAAO,EAAE,OAAO,CAAC,QAAQ;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,+BAAU,CAAC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAClF,IAAI,CAAC;gBACH,oCAAoC;gBACpC,MAAM,IAAA,oBAAY,EAAC,SAAS,EAAE;gBAC5B,mDAAmD;iBACpD,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,+BAAU,CAAC,QAAQ,CAAC,GAAG,8BAAS,CAAC,MAAM,yBAAyB,QAAQ,KAAK,CAAC,CAAC,CAAC;YAC5F,OAAO,CAAC,GAAG,CAAC,GAAG,+BAAU,CAAC,OAAO,CAAC,GAAG,8BAAS,CAAC,UAAU,QAAQ,CAAC,YAAY,+BAAU,CAAC,OAAO,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;QACxI,CAAC;IAEH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAAU,CAAC,SAAS,CAAC,GAAG,8BAAS,CAAC,MAAM,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACnI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/commands/human.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 🧡 faf human - Interactive Human Context Collection
+ * Asks for one W at a time, simple and focused
+ */
+interface HumanOptions {
+    all?: boolean;
+    skip?: boolean;
+    set?: string;
+}
+/**
+ * Main human command
+ */
+export declare function humanCommand(projectPath?: string, options?: HumanOptions): Promise<void>;
+/**
+ * Set a single human_context field (non-interactive)
+ */
+export declare function humanSetCommand(field: string, value: string, projectPath?: string): Promise<void>;
+export {};
+//# sourceMappingURL=human.d.ts.map

package/dist/commands/human.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/commands/human.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA4BD;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,YAAiB,iBA+G3B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,iBAgDrB"}

package/dist/commands/human.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * 🧡 faf human - Interactive Human Context Collection
+ * Asks for one W at a time, simple and focused
+ */
+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.humanCommand = humanCommand;
+exports.humanSetCommand = humanSetCommand;
+const colors_1 = require("../fix-once/colors");
+const fs_1 = require("fs");
+const yaml_1 = require("../fix-once/yaml");
+const championship_style_1 = require("../utils/championship-style");
+const file_utils_1 = require("../utils/file-utils");
+const readline = __importStar(require("readline"));
+const W_FIELDS = [
+    { key: 'who', question: 'WHO is this for?', example: 'e.g., "Developers using AI assistants"' },
+    { key: 'what', question: 'WHAT does it do?', example: 'e.g., "CLI tool for project context"' },
+    { key: 'why', question: 'WHY does it exist?', example: 'e.g., "AI needs persistent context"' },
+    { key: 'where', question: 'WHERE does it run?', example: 'e.g., "npm, browser, edge"' },
+    { key: 'when', question: 'WHEN was it made/status?', example: 'e.g., "v1.0, production ready"' },
+    { key: 'how', question: 'HOW do you use it?', example: 'e.g., "npm install -g faf-cli"' },
+];
+/**
+ * Prompt for a single input
+ */
+async function askQuestion(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Main human command
+ */
+async function humanCommand(projectPath, options = {}) {
+    const projectRoot = projectPath || process.cwd();
+    try {
+        // Find .faf file
+        const fafPath = await (0, file_utils_1.findFafFile)(projectRoot);
+        if (!fafPath) {
+            console.log();
+            console.log(colors_1.chalk.yellow(`${championship_style_1.FAF_ICONS.robot} No .faf file found. Run 'faf init' first.`));
+            return;
+        }
+        // Read existing .faf
+        const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(fafContent) || {};
+        if (!fafData.human_context) {
+            fafData.human_context = {};
+        }
+        // === NON-INTERACTIVE MODE: --set field "value" ===
+        if (options.set) {
+            const validFields = W_FIELDS.map(f => f.key);
+            const field = options.set.toLowerCase();
+            if (!validFields.includes(field)) {
+                console.log();
+                console.log(colors_1.chalk.red(`Unknown field: ${field}`));
+                console.log(colors_1.chalk.gray(`Valid fields: ${validFields.join(', ')}`));
+                return;
+            }
+            // The value comes as the next argument (projectPath in this case)
+            // We need to handle this differently - the value is passed separately
+            console.log();
+            console.log(colors_1.chalk.yellow(`Usage: faf human --set <field> "<value>"`));
+            console.log(colors_1.chalk.gray(`Example: faf human --set why "32x faster than Rust"`));
+            return;
+        }
+        // === INTERACTIVE MODE ===
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafOrange(`${championship_style_1.FAF_ICONS.heart_orange} Human Context Collection`));
+        console.log(colors_1.chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(colors_1.chalk.gray('   Answer each question (Enter to skip)'));
+        console.log();
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        let updatedCount = 0;
+        for (const field of W_FIELDS) {
+            const currentValue = fafData.human_context[field.key];
+            const hasValue = currentValue && currentValue !== null && currentValue !== '';
+            // Skip if already has value and not --all flag
+            if (hasValue && !options.all) {
+                console.log(colors_1.chalk.gray(`   ${field.key.toUpperCase()}: ${currentValue} (keeping)`));
+                continue;
+            }
+            // Show current value if exists
+            if (hasValue) {
+                console.log(colors_1.chalk.gray(`   Current: ${currentValue}`));
+            }
+            // Ask the question
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`   ${field.question}`));
+            console.log(colors_1.chalk.gray(`   ${field.example}`));
+            const answer = await askQuestion(rl, championship_style_1.FAF_COLORS.fafOrange('   > '));
+            if (answer) {
+                fafData.human_context[field.key] = answer;
+                updatedCount++;
+                console.log(colors_1.chalk.green(`   ☑️ ${field.key} updated`));
+            }
+            else if (hasValue) {
+                console.log(colors_1.chalk.gray(`   (kept existing)`));
+            }
+            else {
+                console.log(colors_1.chalk.gray(`   (skipped)`));
+            }
+            console.log();
+        }
+        rl.close();
+        // Save if any updates
+        if (updatedCount > 0) {
+            await fs_1.promises.writeFile(fafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+            console.log(colors_1.chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+            console.log(championship_style_1.FAF_COLORS.fafGreen(`${championship_style_1.FAF_ICONS.heart_orange} Updated ${updatedCount} field${updatedCount > 1 ? 's' : ''}`));
+            console.log(colors_1.chalk.gray('   Run: faf score to see your new score'));
+        }
+        else {
+            console.log(colors_1.chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+            console.log(colors_1.chalk.gray('   No changes made'));
+        }
+        console.log();
+    }
+    catch (error) {
+        console.log(colors_1.chalk.red(`\n${championship_style_1.FAF_ICONS.fire} Human context collection failed:`));
+        console.log(colors_1.chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+/**
+ * Set a single human_context field (non-interactive)
+ */
+async function humanSetCommand(field, value, projectPath) {
+    const projectRoot = projectPath || process.cwd();
+    const validFields = W_FIELDS.map(f => f.key);
+    const fieldLower = field.toLowerCase();
+    if (!validFields.includes(fieldLower)) {
+        console.log();
+        console.log(colors_1.chalk.red(`Unknown field: ${field}`));
+        console.log(colors_1.chalk.gray(`Valid fields: ${validFields.join(', ')}`));
+        return;
+    }
+    try {
+        const fafPath = await (0, file_utils_1.findFafFile)(projectRoot);
+        if (!fafPath) {
+            console.log();
+            console.log(colors_1.chalk.yellow(`${championship_style_1.FAF_ICONS.robot} No .faf file found. Run 'faf init' first.`));
+            return;
+        }
+        const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(fafContent) || {};
+        if (!fafData.human_context) {
+            fafData.human_context = {};
+        }
+        const oldValue = fafData.human_context[fieldLower];
+        fafData.human_context[fieldLower] = value;
+        await fs_1.promises.writeFile(fafPath, (0, yaml_1.stringify)(fafData), 'utf-8');
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafOrange(`${championship_style_1.FAF_ICONS.heart_orange} Human Context Updated`));
+        console.log(colors_1.chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(colors_1.chalk.green(`   ☑️ ${fieldLower.toUpperCase()}: ${value}`));
+        if (oldValue) {
+            console.log(colors_1.chalk.gray(`      (was: ${oldValue})`));
+        }
+        console.log();
+    }
+    catch (error) {
+        console.log(colors_1.chalk.red(`\nFailed to set ${field}:`));
+        console.log(colors_1.chalk.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=human.js.map

package/dist/commands/human.js.map

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

package/dist/commands/readme.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 📖 faf readme - Extract 6 Ws from README intelligently
+ * Reads README.md and fills human_context slots smartly
+ */
+interface ReadmeOptions {
+    apply?: boolean;
+    force?: boolean;
+    file?: string;
+    quiet?: boolean;
+}
+/**
+ * Main readme command
+ */
+export declare function readmeCommand(projectPath?: string, options?: ReadmeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=readme.d.ts.map

package/dist/commands/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../src/commands/readme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyUD;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,aAAkB,iBA4J5B"}