jfl 0.5.0 → 0.6.1

package/dist/lib/setup/context-analyzer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @purpose Analyze GTM context for RL agent recommendations — journals, knowledge docs, git history
+ */
+export interface ProjectContext {
+    journalCount: number;
+    sessionCount: number;
+    hasKnowledge: boolean;
+    hasProductRepo: boolean;
+    agents: string[];
+    topFilePatterns: string[];
+    metricCategories: string[];
+    readinessScore: number;
+    issues: string[];
+}
+export declare function analyzeContext(projectRoot: string): ProjectContext;
+//# sourceMappingURL=context-analyzer.d.ts.map

package/dist/lib/setup/context-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-analyzer.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/context-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,cAAc,EAAE,OAAO,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAiGlE"}

package/dist/lib/setup/context-analyzer.js

@@ -0,0 +1,112 @@
+/**
+ * @purpose Analyze GTM context for RL agent recommendations — journals, knowledge docs, git history
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+export function analyzeContext(projectRoot) {
+    const ctx = {
+        journalCount: 0,
+        sessionCount: 0,
+        hasKnowledge: false,
+        hasProductRepo: false,
+        agents: [],
+        topFilePatterns: [],
+        metricCategories: [],
+        readinessScore: 0,
+        issues: [],
+    };
+    // Count journal entries
+    const journalDir = join(projectRoot, ".jfl", "journal");
+    if (existsSync(journalDir)) {
+        const files = readdirSync(journalDir).filter(f => f.endsWith(".jsonl"));
+        ctx.sessionCount = files.length;
+        for (const file of files) {
+            const content = readFileSync(join(journalDir, file), "utf-8");
+            ctx.journalCount += content.split("\n").filter(l => l.trim()).length;
+        }
+    }
+    // Check knowledge docs
+    const knowledgeDir = join(projectRoot, "knowledge");
+    if (existsSync(knowledgeDir)) {
+        const requiredDocs = ["VISION.md", "ROADMAP.md"];
+        const found = requiredDocs.filter(d => existsSync(join(knowledgeDir, d)));
+        ctx.hasKnowledge = found.length > 0;
+    }
+    // Check product repo
+    ctx.hasProductRepo = existsSync(join(projectRoot, "product")) || existsSync(join(projectRoot, ".jfl", "config.json"));
+    // Existing agents
+    const agentsDir = join(projectRoot, ".jfl", "agents");
+    if (existsSync(agentsDir)) {
+        ctx.agents = readdirSync(agentsDir).filter(f => f.endsWith(".toml")).map(f => f.replace(".toml", ""));
+    }
+    // Identify metric categories from journals
+    const categories = new Set();
+    if (existsSync(journalDir)) {
+        for (const file of readdirSync(journalDir).filter(f => f.endsWith(".jsonl"))) {
+            const content = readFileSync(join(journalDir, file), "utf-8");
+            for (const line of content.split("\n").filter(l => l.trim())) {
+                try {
+                    const entry = JSON.parse(line);
+                    if (entry.type === "fix")
+                        categories.add("error_rate");
+                    if (entry.type === "feature")
+                        categories.add("feature_coverage");
+                    if (entry.files?.some((f) => f.includes("test")))
+                        categories.add("test_coverage");
+                    if (entry.files?.some((f) => f.includes("perf") || f.includes("speed")))
+                        categories.add("performance");
+                    if (entry.files?.some((f) => f.includes("security") || f.includes("auth")))
+                        categories.add("security");
+                }
+                catch { /* skip malformed */ }
+            }
+        }
+    }
+    ctx.metricCategories = [...categories];
+    // File pattern hotspots from training buffer
+    const bufferPath = join(projectRoot, ".jfl", "training-buffer.jsonl");
+    if (existsSync(bufferPath)) {
+        const fileCounts = {};
+        const content = readFileSync(bufferPath, "utf-8");
+        for (const line of content.split("\n").filter(l => l.trim())) {
+            try {
+                const entry = JSON.parse(line);
+                for (const f of entry.action?.files_affected || []) {
+                    const dir = f.split("/").slice(0, 2).join("/");
+                    fileCounts[dir] = (fileCounts[dir] || 0) + 1;
+                }
+            }
+            catch { /* skip */ }
+        }
+        ctx.topFilePatterns = Object.entries(fileCounts)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([pattern]) => `${pattern}/**`);
+    }
+    // Readiness score
+    let score = 0;
+    if (ctx.journalCount >= 20)
+        score += 30;
+    else if (ctx.journalCount >= 10)
+        score += 15;
+    if (ctx.sessionCount >= 3)
+        score += 20;
+    else if (ctx.sessionCount >= 1)
+        score += 10;
+    if (ctx.hasKnowledge)
+        score += 20;
+    if (ctx.hasProductRepo)
+        score += 20;
+    if (ctx.metricCategories.length > 0)
+        score += 10;
+    ctx.readinessScore = score;
+    // Issues
+    if (ctx.journalCount < 20)
+        ctx.issues.push(`Need 20+ journal entries (have ${ctx.journalCount})`);
+    if (ctx.sessionCount < 3)
+        ctx.issues.push(`Need 3+ sessions (have ${ctx.sessionCount})`);
+    if (!ctx.hasKnowledge)
+        ctx.issues.push("No knowledge docs found");
+    return ctx;
+}
+//# sourceMappingURL=context-analyzer.js.map

package/dist/lib/setup/context-analyzer.js.map

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

package/dist/lib/setup/doc-auditor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @purpose Audit GTM workspace docs — bifurcated: framework vs customer docs
+ *
+ * Framework docs: came from templates/skills, compare to upstream, track version drift
+ * Customer docs: PRDs, knowledge, custom content — analyze for staleness, token cost, relevance
+ *
+ * Core insight: "this doc costs you $X per day and adds zero value" > "this doc is long, split it"
+ */
+import type { JournalInsight } from "./smart-recommender.js";
+export type DocOrigin = "framework" | "customer" | "unknown";
+export interface DocState {
+    path: string;
+    relativePath: string;
+    sizeBytes: number;
+    lines: number;
+    lastModified: Date;
+    staleScore: number;
+    bloatScore: number;
+    relevanceScore: number;
+    origin: DocOrigin;
+    tokenEstimate: number;
+    issues: string[];
+    sections: string[];
+    todoCount: number;
+    deadLinks: string[];
+    referenceCount: number;
+}
+export interface DocAuditResult {
+    docs: DocState[];
+    totalDocs: number;
+    totalLines: number;
+    totalBytes: number;
+    totalTokens: number;
+    frameworkDocs: DocState[];
+    customerDocs: DocState[];
+    staleDocs: DocState[];
+    bloatedDocs: DocState[];
+    missingDocs: string[];
+    unreferencedDocs: DocState[];
+    recommendations: DocRecommendation[];
+}
+export interface DocRecommendation {
+    type: "trim" | "update" | "create" | "archive" | "split" | "merge" | "refresh" | "dedupe";
+    target: string;
+    rationale: string;
+    priority: number;
+    estimatedSavings?: string;
+    origin: DocOrigin;
+    action?: string;
+}
+export declare function auditDocs(projectRoot: string, insight: JournalInsight): DocAuditResult;
+export declare function buildDocAuditPrompt(audit: DocAuditResult, insight: JournalInsight): string;
+export declare function getSmartDocRecommendations(projectRoot: string, insight: JournalInsight): Promise<DocRecommendation[]>;
+//# sourceMappingURL=doc-auditor.d.ts.map

package/dist/lib/setup/doc-auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-auditor.d.ts","sourceRoot":"","sources":["../../../src/lib/setup/doc-auditor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAM5D,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,IAAI,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,SAAS,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,QAAQ,EAAE,CAAA;IACzB,YAAY,EAAE,QAAQ,EAAE,CAAA;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAA;IACrB,WAAW,EAAE,QAAQ,EAAE,CAAA;IACvB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,EAAE,QAAQ,EAAE,CAAA;IAC5B,eAAe,EAAE,iBAAiB,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;IACzF,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAkDD,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,cAAc,CA0HhB;AAwaD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,MAAM,CA2CR;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsC9B"}