@entelligentsia/forgecli 1.0.25 → 1.0.36

package/dist/extensions/forgecli/skill-curator-subagent.js.map

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

package/dist/extensions/forgecli/skill-retriever.d.ts

@@ -0,0 +1,84 @@
+import lunr from "lunr";
+import { type Static, Type } from "typebox";
+/**
+ * One skill in the retrieval corpus. `frontmatter` is the parsed YAML head
+ * of the SKILL.md file (matches `loaders/persona-skill-loader.ts` Skill shape
+ * for `frontmatter` field). Only `description` plus selected frontmatter
+ * fields are indexed — the body is intentionally excluded to keep the index
+ * small and keyword-focused.
+ */
+export declare const RetrievableSkillSchema: Type.TObject<{
+    skillId: Type.TString;
+    name: Type.TString;
+    description: Type.TString;
+    frontmatter: Type.TRecord<"^.*$", Type.TUnknown>;
+}>;
+export type RetrievableSkill = Static<typeof RetrievableSkillSchema>;
+export declare const RetrievalHitSchema: Type.TObject<{
+    skillId: Type.TString;
+    score: Type.TNumber;
+}>;
+export type RetrievalHit = Static<typeof RetrievalHitSchema>;
+/**
+ * Runtime attribution supplied by the caller (orchestrator).
+ * These are NEVER fabricated inside the retriever (IL10).
+ */
+export declare const EmitRuntimeSchema: Type.TObject<{
+    storeCli: Type.TString;
+    cwd: Type.TString;
+    sprintId: Type.TString;
+    taskId: Type.TString;
+    role: Type.TString;
+    action: Type.TString;
+    phase: Type.TOptional<Type.TString>;
+    iteration: Type.TOptional<Type.TInteger>;
+    startTimestamp: Type.TString;
+    endTimestamp: Type.TString;
+    durationMinutes: Type.TNumber;
+    model: Type.TString;
+    provider: Type.TString;
+}>;
+export type EmitRuntime = Static<typeof EmitRuntimeSchema>;
+export interface EmitResult {
+    emitted: number;
+    failed: number;
+    stderrs: string[];
+}
+/**
+ * Opaque handle returned by `buildSkillIndex`. Internally pairs the lunr
+ * index with the corpus so `retrieveTopK` can return the original skillIds.
+ */
+export interface SkillIndex {
+    readonly _index: lunr.Index;
+    readonly _byRef: Map<string, RetrievableSkill>;
+}
+/**
+ * Build a BM25 index over the supplied corpus. Indexed fields:
+ *   - `name`        (boost 4) — the skill identifier itself
+ *   - `description` (boost 2) — primary intent text
+ *   - `frontmatter` (boost 1) — tags / aliases
+ *
+ * lunr's default scoring is Okapi BM25.
+ */
+export declare function buildSkillIndex(corpus: readonly RetrievableSkill[]): SkillIndex;
+/**
+ * Return the top-k skills by BM25 score for the given query. Deterministic
+ * for fixed (corpus, query) pairs. Returns `[]` when no token in the query
+ * is present in any indexed field.
+ */
+export declare function retrieveTopK(index: SkillIndex, query: string, k: number): RetrievalHit[];
+/**
+ * Clamp a raw BM25 score into the [0,1] window required by the event
+ * schema (`retrieval_score`). BM25 scores are unbounded above; we apply
+ * `s / (1 + s)` so the relative ordering is preserved while the absolute
+ * value is monotonically squashed into (0,1). Negative scores (lunr never
+ * produces these in practice) clamp to 0.
+ */
+export declare function clampRetrievalScore(rawScore: number): number;
+/**
+ * Emit one `skill_usage` event per supplied hit via
+ * `node <storeCli> emit <sprintId> <json>`. Returns the (emitted, failed)
+ * counts. Never throws on subprocess failure — the failure is surfaced via
+ * the returned counter and stderr text (IL7 — explicit, not silent).
+ */
+export declare function emitSkillUsageEvents(hits: readonly RetrievalHit[], runtime: EmitRuntime): EmitResult;

package/dist/extensions/forgecli/skill-retriever.js

@@ -0,0 +1,246 @@
+// Skill retriever — FORGE-S24-T08.
+//
+// BM25-ranked retrieval over the project's skill corpus using `lunr.js`
+// (exact-pinned in package.json). Each retrieval emits one `skill_usage`
+// event per top-k hit with `retrieved: true` and a populated, [0,1]-clamped
+// `retrieval_score`. Conforms to the canonical event schema variant landed
+// in FORGE-S24-T01 (plugin v0.45.0).
+//
+// Iron Laws (forge-cli-engineer):
+//   IL2  — TypeScript + TypeBox. Schemas defined here; runtime input is
+//          validated by `Value.Parse(...)` at the public entry points.
+//   IL6  — No raw shell-string interpolation. `emitSkillUsageEvents` calls
+//          `spawnSync("node", [storeCli, "emit", sprintId, JSON.stringify(event)])`
+//          — argv array, no shell.
+//   IL7  — No silent continuation past failures. A non-zero `store-cli emit`
+//          exit increments the `failed` counter and the stderr text is
+//          forwarded to the caller in the returned result; nothing is
+//          swallowed.
+//   IL10 — This module is a primitive consumed by orchestrator code. The
+//          orchestrator/caller supplies the runtime attribution
+//          (model/provider/timestamps/durationMinutes) — never fabricated
+//          here.
+//
+// Scope boundary: this module owns ranking + emission. It does NOT crawl
+// the filesystem for skills; corpus construction (reading SKILL.md
+// frontmatter via `loaders/persona-skill-loader.ts`) is the caller's
+// responsibility. Keeping IO out of the retriever keeps the module
+// deterministic and trivially unit-testable.
+import lunr from "lunr";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { spawnStoreCliEmit } from "./lib/spawn-store-cli.js";
+import { isSkillCurationEnabled } from "./skill-curation-flag.js";
+// ── Public schemas ───────────────────────────────────────────────────────
+/**
+ * One skill in the retrieval corpus. `frontmatter` is the parsed YAML head
+ * of the SKILL.md file (matches `loaders/persona-skill-loader.ts` Skill shape
+ * for `frontmatter` field). Only `description` plus selected frontmatter
+ * fields are indexed — the body is intentionally excluded to keep the index
+ * small and keyword-focused.
+ */
+export const RetrievableSkillSchema = Type.Object({
+    skillId: Type.String({ minLength: 1 }),
+    name: Type.String({ minLength: 1 }),
+    description: Type.String(),
+    frontmatter: Type.Record(Type.String(), Type.Unknown()),
+});
+export const RetrievalHitSchema = Type.Object({
+    skillId: Type.String({ minLength: 1 }),
+    score: Type.Number(),
+});
+/**
+ * Runtime attribution supplied by the caller (orchestrator).
+ * These are NEVER fabricated inside the retriever (IL10).
+ */
+export const EmitRuntimeSchema = Type.Object({
+    storeCli: Type.String({ minLength: 1 }),
+    cwd: Type.String({ minLength: 1 }),
+    sprintId: Type.String({ minLength: 1 }),
+    taskId: Type.String({ minLength: 1 }),
+    role: Type.String({ minLength: 1 }),
+    action: Type.String({ minLength: 1 }),
+    phase: Type.Optional(Type.String()),
+    iteration: Type.Optional(Type.Integer({ minimum: 1 })),
+    startTimestamp: Type.String({ format: "date-time" }),
+    endTimestamp: Type.String({ format: "date-time" }),
+    durationMinutes: Type.Number({ minimum: 0 }),
+    model: Type.String({ minLength: 1 }),
+    provider: Type.String({ minLength: 1 }),
+});
+/** Join indexable frontmatter fields (tags + name) into a single string. */
+function frontmatterText(fm) {
+    const parts = [];
+    if (typeof fm.name === "string")
+        parts.push(fm.name);
+    const tags = fm.tags;
+    if (Array.isArray(tags)) {
+        for (const t of tags)
+            if (typeof t === "string")
+                parts.push(t);
+    }
+    const aliases = fm.aliases;
+    if (Array.isArray(aliases)) {
+        for (const a of aliases)
+            if (typeof a === "string")
+                parts.push(a);
+    }
+    return parts.join(" ");
+}
+/**
+ * Build a BM25 index over the supplied corpus. Indexed fields:
+ *   - `name`        (boost 4) — the skill identifier itself
+ *   - `description` (boost 2) — primary intent text
+ *   - `frontmatter` (boost 1) — tags / aliases
+ *
+ * lunr's default scoring is Okapi BM25.
+ */
+export function buildSkillIndex(corpus) {
+    for (const s of corpus)
+        Value.Parse(RetrievableSkillSchema, s);
+    const byRef = new Map();
+    for (const s of corpus)
+        byRef.set(s.skillId, s);
+    const index = lunr(function () {
+        this.ref("skillId");
+        this.field("name", { boost: 4 });
+        this.field("description", { boost: 2 });
+        this.field("frontmatter", { boost: 1 });
+        // Determinism: lunr's pipeline is deterministic by construction; we do
+        // not register custom plugins or randomised tokenisers.
+        for (const s of corpus) {
+            this.add({
+                skillId: s.skillId,
+                name: s.name,
+                description: s.description,
+                frontmatter: frontmatterText(s.frontmatter),
+            });
+        }
+    });
+    return { _index: index, _byRef: byRef };
+}
+// ── Retrieval ────────────────────────────────────────────────────────────
+/**
+ * Tokenise the query for lunr. We lower-case, strip non-alphanumerics, and
+ * drop empties. Avoids lunr's query-language operators (`:`, `^`, `~`,
+ * `+`, `-`, `*`) leaking from natural-language task descriptions.
+ */
+function safeQueryTokens(query) {
+    return query
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]+/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length > 0);
+}
+/**
+ * Return the top-k skills by BM25 score for the given query. Deterministic
+ * for fixed (corpus, query) pairs. Returns `[]` when no token in the query
+ * is present in any indexed field.
+ */
+export function retrieveTopK(index, query, k) {
+    if (!Number.isInteger(k) || k <= 0) {
+        throw new Error(`retrieveTopK: k must be a positive integer, got ${k}`);
+    }
+    const tokens = safeQueryTokens(query);
+    if (tokens.length === 0)
+        return [];
+    let results;
+    try {
+        results = index._index.query((q) => {
+            for (const t of tokens) {
+                q.term(t, { usePipeline: true, boost: 1 });
+            }
+        });
+    }
+    catch {
+        // lunr throws on a small set of malformed inputs; treat as no hits
+        // rather than propagating an opaque error into the orchestrator.
+        return [];
+    }
+    const hits = [];
+    for (const r of results) {
+        if (hits.length >= k)
+            break;
+        if (!index._byRef.has(r.ref))
+            continue;
+        hits.push({ skillId: r.ref, score: r.score });
+    }
+    return hits;
+}
+// ── Emission ─────────────────────────────────────────────────────────────
+/**
+ * Clamp a raw BM25 score into the [0,1] window required by the event
+ * schema (`retrieval_score`). BM25 scores are unbounded above; we apply
+ * `s / (1 + s)` so the relative ordering is preserved while the absolute
+ * value is monotonically squashed into (0,1). Negative scores (lunr never
+ * produces these in practice) clamp to 0.
+ */
+export function clampRetrievalScore(rawScore) {
+    if (!Number.isFinite(rawScore) || rawScore <= 0)
+        return 0;
+    const squashed = rawScore / (1 + rawScore);
+    if (squashed >= 1)
+        return 1;
+    return squashed;
+}
+/** Compose an ISO-compact timestamp segment for the eventId. */
+function isoCompact(iso) {
+    return iso.replace(/[-:.]/g, "").replace(/Z$/, "Z");
+}
+/**
+ * Emit one `skill_usage` event per supplied hit via
+ * `node <storeCli> emit <sprintId> <json>`. Returns the (emitted, failed)
+ * counts. Never throws on subprocess failure — the failure is surfaced via
+ * the returned counter and stderr text (IL7 — explicit, not silent).
+ */
+export function emitSkillUsageEvents(hits, runtime) {
+    // FORGE-S24-T12 — gated rollout. Default off ⇒ zero events, zero
+    // subprocess calls, byte-identical to pre-FORGE-S24 behaviour.
+    if (!isSkillCurationEnabled(runtime.cwd)) {
+        return { emitted: 0, failed: 0, stderrs: [] };
+    }
+    Value.Parse(EmitRuntimeSchema, runtime);
+    let emitted = 0;
+    let failed = 0;
+    const stderrs = [];
+    for (let i = 0; i < hits.length; i++) {
+        const hit = hits[i];
+        const eventId = `${isoCompact(runtime.startTimestamp)}_${runtime.taskId}_skill-retriever_skill_usage_${i}_${hit.skillId}`;
+        const event = {
+            eventId,
+            sprintId: runtime.sprintId,
+            taskId: runtime.taskId,
+            role: runtime.role,
+            action: runtime.action,
+            startTimestamp: runtime.startTimestamp,
+            endTimestamp: runtime.endTimestamp,
+            durationMinutes: runtime.durationMinutes,
+            model: runtime.model,
+            provider: runtime.provider,
+            type: "skill_usage",
+            skillId: hit.skillId,
+            retrieved: true,
+            used: false,
+            // No tool calls have happened yet at retrieval time. T09 (usage
+            // tracker) will later emit a follow-up event with the observed
+            // success rate.
+            tool_call_success_rate: 0,
+            retrieval_score: clampRetrievalScore(hit.score),
+        };
+        if (runtime.phase !== undefined)
+            event.phase = runtime.phase;
+        if (runtime.iteration !== undefined)
+            event.iteration = runtime.iteration;
+        // FORGE-S25-T17: adopt spawnStoreCliEmit; adds missing 10 s timeout (N-C-A).
+        const emitResult = spawnStoreCliEmit(runtime.storeCli, runtime.sprintId, event, runtime.cwd);
+        if (emitResult.ok) {
+            emitted++;
+        }
+        else {
+            failed++;
+            stderrs.push(emitResult.stderr);
+        }
+    }
+    return { emitted, failed, stderrs };
+}
+//# sourceMappingURL=skill-retriever.js.map

package/dist/extensions/forgecli/skill-retriever.js.map

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

package/dist/extensions/forgecli/skill-usage-tracker.d.ts

@@ -0,0 +1,91 @@
+import { type Static, Type } from "typebox";
+/**
+ * One skill that was previously retrieved (T08) and is now being evaluated
+ * for actual usage. `workflowSteps` is the list of declared step / tool /
+ * action names the skill's SKILL.md (or workflow doc) advertises — these
+ * are what we diff the trajectory against.
+ *
+ * Step matching is case-insensitive substring: a tool call's `name` matches
+ * a workflow step if the step (after lowercasing + whitespace collapse)
+ * appears anywhere in the tool call's name. This is intentionally permissive
+ * — declared steps are human-authored phrases ("store-cli query"), and tool
+ * call names may be qualified (`mcp__store__store-cli-query`). Misses bias
+ * toward `used: false`, which is the safer of the two error modes for a
+ * curation signal.
+ */
+export declare const RetrievedSkillForTrackingSchema: Type.TObject<{
+    skillId: Type.TString;
+    name: Type.TString;
+    workflowSteps: Type.TArray<Type.TString>;
+}>;
+export type RetrievedSkillForTracking = Static<typeof RetrievedSkillForTrackingSchema>;
+/** One observed tool invocation in the task's trajectory. */
+export declare const ToolCallObservationSchema: Type.TObject<{
+    name: Type.TString;
+}>;
+export type ToolCallObservation = Static<typeof ToolCallObservationSchema>;
+/**
+ * The observable trajectory of a closed task: the sequence of tool calls
+ * the agent made, plus the concatenated reasoning / assistant text the
+ * orchestrator captured. Both inputs are supplied by the caller — this
+ * module does not read transcripts itself.
+ */
+export declare const TaskTrajectorySchema: Type.TObject<{
+    toolCalls: Type.TArray<Type.TObject<{
+        name: Type.TString;
+    }>>;
+    reasoningText: Type.TString;
+}>;
+export type TaskTrajectory = Static<typeof TaskTrajectorySchema>;
+/**
+ * Runtime attribution supplied by the caller (orchestrator).
+ * These are NEVER fabricated inside the tracker (IL10).
+ */
+export declare const EmitRuntimeSchema: Type.TObject<{
+    storeCli: Type.TString;
+    cwd: Type.TString;
+    sprintId: Type.TString;
+    taskId: Type.TString;
+    role: Type.TString;
+    action: Type.TString;
+    phase: Type.TOptional<Type.TString>;
+    iteration: Type.TOptional<Type.TInteger>;
+    startTimestamp: Type.TString;
+    endTimestamp: Type.TString;
+    durationMinutes: Type.TNumber;
+    model: Type.TString;
+    provider: Type.TString;
+}>;
+export type EmitRuntime = Static<typeof EmitRuntimeSchema>;
+export interface EmitResult {
+    emitted: number;
+    failed: number;
+    stderrs: string[];
+}
+/** Why the classifier ruled `used: true`, or `"none"` when it ruled false. */
+export type UsageSignal = "overlap" | "reasoning" | "none";
+export interface UsageVerdict {
+    used: boolean;
+    signal: UsageSignal;
+    tool_call_success_rate: number;
+}
+/**
+ * Apply the FORGE-S24-T09 heuristic to a single retrieved skill against
+ * the observed task trajectory. Pure function — no IO, no allocation
+ * beyond return value.
+ */
+export declare function classifySkillUsage(skill: RetrievedSkillForTracking, trajectory: TaskTrajectory): UsageVerdict;
+/**
+ * Emit one `skill_usage` tracking event per retrieved skill via
+ * `node <storeCli> emit <sprintId> <json>`. Each event carries the
+ * classifier's `used` verdict and the observed `tool_call_success_rate`.
+ *
+ * `retrieval_score` is set to 0 — at tracking time, the score has already
+ * been emitted in the T08 retrieval event; this follow-up captures the
+ * usage signal only. (The schema requires the field to be present; it does
+ * not require it to be re-derived per emission.)
+ *
+ * Never throws on subprocess failure — the failure is surfaced via the
+ * returned counter and stderr text (IL7, explicit not silent).
+ */
+export declare function emitSkillUsageTrackingEvents(retrieved: readonly RetrievedSkillForTracking[], trajectory: TaskTrajectory, runtime: EmitRuntime): EmitResult;