@10et/cli 1.0.0

package/dist/lib/tool-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/lib/tool-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAC1B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAID,eAAO,MAAM,SAAS,EAAE,UAAU,EA0NjC,CAAA;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,GAAG,CAAA;CACjB,CAAC,CAMD;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/tool-schemas.js

@@ -0,0 +1,246 @@
+/**
+ * Shared tool schemas for MCP and Pi.
+ *
+ * Single source of truth for tool names, descriptions, and input schemas.
+ * Both the MCP server (context-hub-mcp.ts) and Pi extension (packages/pi)
+ * consume these definitions — edit here, both get the change.
+ *
+ * Hub tools: proxy to Context Hub HTTP endpoints
+ * CLI tools: wrap jfl CLI commands
+ * Library tools: call jfl-cli library functions directly
+ *
+ * @purpose Single source of truth for all tool schemas used by MCP + Pi
+ */
+// ─── Hub-backed tools (both MCP and Pi) ─────────────────────────────────────
+export const HUB_TOOLS = [
+    {
+        name: "context",
+        description: "Get unified project context: journal entries, knowledge docs, code headers. Use at session start and when you need project state.",
+        hubEndpoint: "/api/context",
+        hubMethod: "POST",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Optional search query to filter results",
+                },
+                taskType: {
+                    type: "string",
+                    enum: ["code", "spec", "content", "strategy", "general"],
+                    description: "Type of task for context prioritization",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results to return (default: 30)",
+                },
+            },
+        },
+    },
+    {
+        name: "context_search",
+        description: "Search across all context sources (journal, knowledge, code) for relevant information.",
+        hubEndpoint: "/api/context/search",
+        hubMethod: "POST",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query",
+                },
+                maxItems: {
+                    type: "number",
+                    description: "Maximum results (default: 20)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "context_status",
+        description: "Check Context Hub status and available sources.",
+        hubEndpoint: "/api/context/status",
+        hubMethod: "GET",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "context_sessions",
+        description: "See activity from other sessions (informational only).",
+        hubEndpoint: "/api/context/status",
+        hubMethod: "GET",
+        inputSchema: {
+            type: "object",
+            properties: {
+                hours: {
+                    type: "number",
+                    description: "Hours of history to include (default: 24)",
+                },
+            },
+        },
+    },
+    {
+        name: "memory_search",
+        description: "Search JFL project memory — find past decisions, learnings, and patterns across all sessions.",
+        hubEndpoint: "/api/memory/search",
+        hubMethod: "POST",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query to find relevant memories",
+                },
+                type: {
+                    type: "string",
+                    enum: ["feature", "fix", "decision", "discovery", "milestone", "all"],
+                    description: "Filter by entry type",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum results (default: 10)",
+                },
+                since: {
+                    type: "string",
+                    description: "ISO date — only entries after this date",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "memory_add",
+        description: "Add a memory/note to persist across sessions. Useful for capturing insights not in journal.",
+        hubEndpoint: "/api/memory/add",
+        hubMethod: "POST",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Short title for the memory",
+                },
+                content: {
+                    type: "string",
+                    description: "Full content/description",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags for categorization",
+                },
+            },
+            required: ["title", "content"],
+        },
+    },
+    {
+        name: "memory_status",
+        description: "Get memory system health and stats.",
+        hubEndpoint: "/api/memory/status",
+        hubMethod: "GET",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "events_publish",
+        description: "Publish an event to the MAP event bus. Signal state changes, task completion, or custom events.",
+        hubEndpoint: "/api/events",
+        hubMethod: "POST",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    description: "Event type (e.g., 'task:completed', 'decision:made')",
+                },
+                source: {
+                    type: "string",
+                    description: "Event source identifier",
+                },
+                data: {
+                    type: "object",
+                    description: "Event payload data",
+                },
+                target: {
+                    type: "string",
+                    description: "Optional specific consumer",
+                },
+            },
+            required: ["type", "source"],
+        },
+    },
+    {
+        name: "events_recent",
+        description: "Get recent events from the MAP event bus. Check what happened across services and agents.",
+        hubEndpoint: "/api/events",
+        hubMethod: "GET",
+        inputSchema: {
+            type: "object",
+            properties: {
+                pattern: {
+                    type: "string",
+                    description: "Glob pattern to filter events (e.g., 'peter:*', '*')",
+                },
+                since: {
+                    type: "string",
+                    description: "ISO date — only events after this time",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum events to return (default: 20)",
+                },
+            },
+        },
+    },
+    {
+        name: "experiment_history",
+        description: "Search past experiments, outcomes, and learnings. Use before new experiments to avoid repeating failures.",
+        hubEndpoint: "/api/eval/trajectory",
+        hubMethod: "GET",
+        inputSchema: {
+            type: "object",
+            properties: {
+                files: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by files changed",
+                },
+                minDelta: {
+                    type: "number",
+                    description: "Min score improvement",
+                },
+                maxAge: {
+                    type: "string",
+                    description: "Max age e.g. 7d, 30d",
+                },
+                outcome: {
+                    type: "string",
+                    enum: ["confirmed", "rejected", "inconclusive"],
+                    description: "Filter by experiment outcome",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default: 20)",
+                },
+            },
+        },
+    },
+];
+// ─── Helper: convert to MCP format ──────────────────────────────────────────
+export function toMcpTools(schemas) {
+    return schemas.map((s) => ({
+        name: s.name === "context" ? "context_get" : s.name,
+        description: s.description,
+        inputSchema: { ...s.inputSchema, type: "object" },
+    }));
+}
+// ─── Helper: convert to Pi format ───────────────────────────────────────────
+export function toPiToolName(name) {
+    return `jfl_${name}`;
+}
+//# sourceMappingURL=tool-schemas.js.map

package/dist/lib/tool-schemas.js.map

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

package/dist/lib/training-buffer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @purpose Write (state, action, reward) training tuples for policy head training — generalized for any RL agent
+ */
+export interface RLState {
+    composite_score: number;
+    dimension_scores: Record<string, number>;
+    tests_passing: number;
+    tests_total: number;
+    trajectory_length: number;
+    recent_deltas: number[];
+    agent: string;
+}
+export interface RLAction {
+    type: "fix" | "refactor" | "feature" | "test" | "config" | "experiment";
+    description: string;
+    files_affected: string[];
+    scope: "small" | "medium" | "large";
+    branch: string;
+    code_diff?: string;
+}
+export interface RLReward {
+    composite_delta: number;
+    dimension_deltas: Record<string, number>;
+    tests_added: number;
+    quality_score: number;
+    improved: boolean;
+    prediction_error?: number;
+}
+export interface TrainingBufferEntry {
+    id: string;
+    v: 1;
+    ts: string;
+    agent: string;
+    wave?: string;
+    state: RLState;
+    action: RLAction;
+    reward: RLReward;
+    metadata: {
+        pr_number?: number;
+        branch: string;
+        eval_run_id?: string;
+        prediction_id?: string;
+        autoresearch_round?: number;
+        source: "ci" | "autoresearch" | "experiment" | "manual" | "mined";
+        mine_source?: string;
+        scopes?: string[];
+        changed_files?: string[];
+        session_id?: string;
+        round?: number;
+        hypothesis?: string;
+    };
+}
+export declare function hashEntry(state: RLState, action: RLAction): string;
+export declare class TrainingBuffer {
+    private bufferPath;
+    private projectRoot;
+    constructor(projectRoot?: string, storage?: any);
+    append(entry: Omit<TrainingBufferEntry, "id" | "v" | "ts">): TrainingBufferEntry;
+    read(): TrainingBufferEntry[];
+    /**
+     * Read training buffer entries from all registered services.
+     * Use this from GTM hub to get cross-project training data.
+     */
+    readAll(): TrainingBufferEntry[];
+    private static readFromPath;
+    stats(): {
+        total: number;
+        byAgent: Record<string, number>;
+        bySource: Record<string, number>;
+        avgReward: number;
+        improvedRate: number;
+    };
+    /**
+     * Export in format ready for policy head training:
+     * Each entry becomes a (state_text, action_text, reward) triple
+     * that can be embedded via Stratus for the policy head
+     */
+    exportForTraining(): Array<{
+        state_text: string;
+        action_text: string;
+        reward: number;
+        agent: string;
+        ts: string;
+    }>;
+}
+//# sourceMappingURL=training-buffer.d.ts.map

package/dist/lib/training-buffer.d.ts.map

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

package/dist/lib/training-buffer.js

@@ -0,0 +1,139 @@
+/**
+ * @purpose Write (state, action, reward) training tuples for policy head training — generalized for any RL agent
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { createHash } from "crypto";
+export function hashEntry(state, action) {
+    const content = JSON.stringify({ s: state.composite_score, a: action.description, t: action.type });
+    return createHash("sha256").update(content).digest("hex").slice(0, 12);
+}
+function findProjectRoot() {
+    let dir = process.cwd();
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, ".jfl", "config.json")))
+            return dir;
+        if (existsSync(join(dir, ".jfl")))
+            return dir;
+        dir = dirname(dir);
+    }
+    return process.cwd();
+}
+export class TrainingBuffer {
+    bufferPath;
+    projectRoot;
+    constructor(projectRoot, storage) {
+        this.projectRoot = projectRoot || findProjectRoot();
+        this.bufferPath = join(this.projectRoot, ".jfl", "training-buffer.jsonl");
+    }
+    append(entry) {
+        const full = {
+            id: `tb_${hashEntry(entry.state, entry.action)}`,
+            v: 1,
+            ts: new Date().toISOString(),
+            ...entry,
+        };
+        const dir = dirname(this.bufferPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(this.bufferPath, JSON.stringify(full) + "\n");
+        return full;
+    }
+    read() {
+        return TrainingBuffer.readFromPath(this.bufferPath);
+    }
+    /**
+     * Read training buffer entries from all registered services.
+     * Use this from GTM hub to get cross-project training data.
+     */
+    readAll() {
+        const entries = this.read();
+        // Check if this project is a GTM or portfolio — aggregate from services
+        const configPath = join(this.projectRoot, ".jfl", "config.json");
+        if (existsSync(configPath)) {
+            try {
+                const config = JSON.parse(readFileSync(configPath, "utf-8"));
+                if ((config.type === "gtm" || config.type === "portfolio") && config.registered_services) {
+                    const seen = new Set(entries.map(e => e.id));
+                    for (const svc of config.registered_services) {
+                        if (!svc.path)
+                            continue;
+                        const svcBufferPath = join(svc.path, ".jfl", "training-buffer.jsonl");
+                        const svcEntries = TrainingBuffer.readFromPath(svcBufferPath);
+                        for (const entry of svcEntries) {
+                            if (!seen.has(entry.id)) {
+                                entries.push(entry);
+                                seen.add(entry.id);
+                            }
+                        }
+                    }
+                }
+            }
+            catch { }
+        }
+        return entries;
+    }
+    static readFromPath(bufferPath) {
+        if (!existsSync(bufferPath))
+            return [];
+        const entries = [];
+        const lines = readFileSync(bufferPath, "utf-8").split("\n");
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch { }
+        }
+        return entries;
+    }
+    stats() {
+        const entries = this.read();
+        const byAgent = {};
+        const bySource = {};
+        let rewardSum = 0;
+        let improvedCount = 0;
+        for (const e of entries) {
+            byAgent[e.agent] = (byAgent[e.agent] || 0) + 1;
+            bySource[e.metadata.source] = (bySource[e.metadata.source] || 0) + 1;
+            rewardSum += e.reward.composite_delta;
+            if (e.reward.improved)
+                improvedCount++;
+        }
+        return {
+            total: entries.length,
+            byAgent,
+            bySource,
+            avgReward: entries.length > 0 ? rewardSum / entries.length : 0,
+            improvedRate: entries.length > 0 ? improvedCount / entries.length : 0,
+        };
+    }
+    /**
+     * Export in format ready for policy head training:
+     * Each entry becomes a (state_text, action_text, reward) triple
+     * that can be embedded via Stratus for the policy head
+     */
+    exportForTraining() {
+        const entries = this.read();
+        return entries.map(e => ({
+            state_text: [
+                `Composite: ${e.state.composite_score.toFixed(4)}`,
+                `Tests: ${e.state.tests_passing}/${e.state.tests_total}`,
+                `Dimensions: ${Object.entries(e.state.dimension_scores).map(([k, v]) => `${k}=${v.toFixed(4)}`).join(", ")}`,
+                `Trajectory length: ${e.state.trajectory_length}`,
+                `Recent deltas: ${e.state.recent_deltas.map(d => (d >= 0 ? "+" : "") + d.toFixed(4)).join(", ")}`,
+            ].join("\n"),
+            action_text: [
+                `Type: ${e.action.type}`,
+                `Description: ${e.action.description}`,
+                `Scope: ${e.action.scope}`,
+                `Files: ${e.action.files_affected.join(", ")}`,
+            ].join("\n"),
+            reward: e.reward.composite_delta,
+            agent: e.agent,
+            ts: e.ts,
+        }));
+    }
+}
+//# sourceMappingURL=training-buffer.js.map

package/dist/lib/training-buffer.js.map

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

package/dist/lib/training-tuples.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @purpose Extract (state, action, reward) training tuples from ProductRank team journal files
+ */
+export interface TrainingTuple {
+    id: string;
+    timestamp: string;
+    team: string;
+    state: {
+        approach: string;
+        scores: Record<string, number> | null;
+        iteration: number;
+        filesChanged: string[];
+    };
+    action: {
+        type: string;
+        description: string;
+        detail: string;
+    };
+    reward: {
+        scoreDelta: number | null;
+        qualitative: "improvement" | "regression" | "neutral" | "unknown";
+        learned: string[];
+    };
+    source: {
+        file: string;
+        session: string;
+        entryIndex: number;
+    };
+}
+export declare function extractScores(text: string): Record<string, number> | null;
+export declare function extractTuples(journalDir: string, team?: string): TrainingTuple[];
+export declare function formatTuplesReport(tuples: TrainingTuple[]): string;
+//# sourceMappingURL=training-tuples.d.ts.map

package/dist/lib/training-tuples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-tuples.d.ts","sourceRoot":"","sources":["../../src/lib/training-tuples.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QACrC,SAAS,EAAE,MAAM,CAAA;QACjB,YAAY,EAAE,MAAM,EAAE,CAAA;KACvB,CAAA;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,WAAW,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;QACjE,OAAO,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAgCD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiCzE;AAsFD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAiDhF;AA4DD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CA0ElE"}