xtctx 0.3.2 → 0.11.3

package/dist/src/config/skills.js

@@ -0,0 +1,427 @@
+import { createHash } from "node:crypto";
+import { readdir, readFile, rm, stat, mkdir } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { writeFileAtomic } from "../utils/atomic-file.js";
+import { parse as parseYaml } from "yaml";
+import { SUPPORTED_TOOLS } from "../tools/sources.js";
+export const BUILT_IN_SKILL_ID = "xtctx-handoff";
+const HASH_PREFIX = "sha256:";
+const SKILL_HASH_PATTERN = /xtctx:skill-hash\s+([a-z0-9:]+)/i;
+export async function syncProjectSkills(options) {
+    const projectRoot = resolve(options.projectRoot);
+    const sourceDir = skillSourceDir(projectRoot);
+    const existing = await readExistingSkillConfig(options.configPath);
+    const discovered = await discoverProjectSkills({ projectRoot, homeDir: options.homeDir });
+    const selectedIds = resolveSelectedSkillIds(existing, options.selectedSkillIds);
+    const writes = [];
+    const warnings = [];
+    await mkdir(sourceDir, { recursive: true });
+    for (const skillId of selectedIds) {
+        const sourcePath = join(sourceDir, skillId, "SKILL.md");
+        const discoveredSkill = discovered.find((skill) => skill.id === skillId);
+        const content = skillId === BUILT_IN_SKILL_ID ? builtInHandoffSkill() : discoveredSkill?.content;
+        if (!content) {
+            warnings.push(`Selected skill ${skillId} was not found in connected tool skill sources.`);
+            continue;
+        }
+        writes.push({
+            path: sourcePath,
+            kind: `skill-source:${skillId}`,
+            changed: await writeIfChanged(sourcePath, content),
+        });
+    }
+    const selected = await readSelectedSkills(sourceDir, selectedIds);
+    const targetConfig = buildTargetConfig(projectRoot);
+    for (const skill of selected) {
+        for (const tool of SUPPORTED_TOOLS) {
+            const capability = tool.skillSync;
+            if (!capability || capability.mode === "unsupported" || capability.mode === "managed-block") {
+                continue;
+            }
+            const targetPath = capability.targetPath?.(projectRoot, skill.id);
+            if (!targetPath) {
+                continue;
+            }
+            const write = await syncSkillToTarget({
+                skill,
+                mode: capability.mode,
+                targetPath,
+            });
+            writes.push({ path: write.path, kind: `skill:${tool.id}:${skill.id}`, changed: write.changed });
+        }
+    }
+    for (const tool of SUPPORTED_TOOLS.filter((item) => item.skillSync?.mode === "unsupported")) {
+        warnings.push(`${tool.label} has no verified native skill or instruction surface; skill sync is not installed there.`);
+    }
+    return {
+        config: {
+            sourceDir: ".xtctx/skills",
+            selected: Object.fromEntries(selected.map((skill) => [skill.id, { hash: skill.hash, source: toProjectRelative(projectRoot, skill.path) }])),
+            targets: targetConfig,
+        },
+        selected,
+        writes,
+        warnings,
+    };
+}
+export async function discoverProjectSkills(options) {
+    const projectRoot = resolve(options.projectRoot);
+    const home = options.homeDir ?? process.env.USERPROFILE ?? process.env.HOME ?? "";
+    const codexHome = process.env.CODEX_HOME ?? (home ? join(home, ".codex") : "");
+    const candidates = [
+        { source: "xtctx", root: skillSourceDir(projectRoot) },
+        { source: "claude-code project", root: join(projectRoot, ".claude", "skills") },
+        { source: "claude-code user", root: home ? join(home, ".claude", "skills") : "" },
+        { source: "codex project", root: join(projectRoot, ".codex", "skills") },
+        { source: "codex user", root: codexHome ? join(codexHome, "skills") : "" },
+    ].filter((candidate) => candidate.root.length > 0);
+    const discovered = [
+        parseSkillContent(BUILT_IN_SKILL_ID, builtInHandoffSkill(), "<built-in>", "xtctx built-in"),
+    ];
+    for (const candidate of candidates) {
+        const entries = await readSkillDir(candidate.root, candidate.source);
+        for (const entry of entries) {
+            if (!discovered.some((skill) => skill.id === entry.id)) {
+                discovered.push(entry);
+            }
+        }
+    }
+    return discovered.sort((left, right) => left.id.localeCompare(right.id));
+}
+export async function inspectSkillStatus(projectRoot, configPath) {
+    const root = resolve(projectRoot);
+    const sourceDir = skillSourceDir(root);
+    const existing = await readExistingSkillConfig(configPath);
+    const selectedIds = resolveSelectedSkillIds(existing);
+    const selected = await Promise.all(selectedIds.map(async (id) => {
+        const path = join(sourceDir, id, "SKILL.md");
+        const content = await readUtf8IfExists(path);
+        return {
+            id,
+            exists: content !== null,
+            hash: content ? hashContent(content) : undefined,
+        };
+    }));
+    const targets = [];
+    for (const tool of SUPPORTED_TOOLS) {
+        const capability = tool.skillSync;
+        const mode = capability?.mode ?? "unsupported";
+        if (mode === "unsupported") {
+            targets.push({ tool: tool.id, mode, state: "unsupported" });
+            continue;
+        }
+        if (mode === "managed-block") {
+            targets.push({
+                tool: tool.id,
+                mode,
+                path: capability?.targetPath?.(root, BUILT_IN_SKILL_ID),
+                state: "managed-block",
+            });
+            continue;
+        }
+        for (const skill of selected) {
+            const targetPath = capability?.targetPath?.(root, skill.id);
+            if (!targetPath) {
+                targets.push({ tool: tool.id, mode, skillId: skill.id, state: "unsupported" });
+                continue;
+            }
+            const content = await readUtf8IfExists(targetPath);
+            let state = "missing";
+            if (content !== null && skill.hash) {
+                state = targetHasHash(content, skill.hash, mode) ? "ok" : "drift";
+            }
+            targets.push({ tool: tool.id, mode, skillId: skill.id, path: targetPath, state });
+        }
+    }
+    return { sourceDir, selected, targets };
+}
+export async function removeSyncedSkillsForTools(projectRoot, tools) {
+    const root = resolve(projectRoot);
+    const writes = [];
+    const selectedIds = await listCanonicalSkillIds(skillSourceDir(root));
+    for (const toolId of tools) {
+        const tool = SUPPORTED_TOOLS.find((item) => item.id === toolId);
+        const capability = tool?.skillSync;
+        if (!capability || capability.mode === "unsupported" || capability.mode === "managed-block") {
+            continue;
+        }
+        for (const skillId of selectedIds) {
+            const targetPath = capability.targetPath?.(root, skillId);
+            if (!targetPath) {
+                continue;
+            }
+            const changed = await removePath(targetPath);
+            writes.push({ path: targetPath, kind: `skill:${toolId}:${skillId}`, changed });
+        }
+    }
+    return writes;
+}
+export function renderSyncedSkillsBlock(selected) {
+    if (selected.length === 0) {
+        return [];
+    }
+    return [
+        "## Synced Skills",
+        "- Canonical project skills live in `.xtctx/skills`.",
+        "- If a task matches a synced skill, read that skill file before following it.",
+        ...selected.map((skill) => `- ${skill.id}: \`.xtctx/skills/${skill.id}/SKILL.md\``),
+        "",
+    ];
+}
+function resolveSelectedSkillIds(existing, explicit) {
+    const ids = explicit && explicit.length > 0 ? explicit : existing.selectedIds;
+    return uniqueIds([BUILT_IN_SKILL_ID, ...ids]);
+}
+async function readSelectedSkills(sourceDir, selectedIds) {
+    const selected = [];
+    for (const id of selectedIds) {
+        const path = join(sourceDir, id, "SKILL.md");
+        const content = await readUtf8IfExists(path);
+        if (content === null) {
+            continue;
+        }
+        selected.push({ id, path, source: toPosixPath(path), hash: hashContent(content) });
+    }
+    return selected;
+}
+async function syncSkillToTarget(input) {
+    const content = await readFile(input.skill.path, "utf-8");
+    const parsed = parseSkillContent(input.skill.id, content, input.skill.path, "xtctx");
+    const rendered = renderTargetContent({
+        skill: parsed,
+        sourceHash: input.skill.hash,
+        mode: input.mode,
+        content,
+    });
+    return {
+        path: input.targetPath,
+        changed: await writeIfChanged(input.targetPath, rendered),
+    };
+}
+function renderTargetContent(input) {
+    if (input.mode === "native-skill") {
+        return `${normalizeNewlines(input.content).trimEnd()}\n`;
+    }
+    const title = input.skill.name || input.skill.id;
+    const header = [
+        "<!-- xtctx:skill begin -->",
+        `<!-- xtctx:skill-id ${input.skill.id} -->`,
+        `<!-- xtctx:skill-hash ${input.sourceHash} -->`,
+        "Generated by xtctx setup. Do not edit this file directly.",
+        "",
+    ].join("\n");
+    const body = stripFrontmatter(input.content).trim();
+    const footer = "\n\n<!-- xtctx:skill end -->\n";
+    if (input.mode === "rule-adapter") {
+        return [
+            "---",
+            `description: ${quoteYamlString(`${input.skill.description} Synced from xtctx project skills.`)}`,
+            'globs: "**/*"',
+            "alwaysApply: false",
+            "---",
+            "",
+            header,
+            `# ${title}`,
+            "",
+            body,
+            footer,
+        ].join("\n");
+    }
+    if (input.mode === "instruction-adapter") {
+        return [
+            "---",
+            'applyTo: "**"',
+            "---",
+            "",
+            header,
+            `# ${title}`,
+            "",
+            body,
+            footer,
+        ].join("\n");
+    }
+    switch (input.mode) {
+        case "managed-block":
+        case "unsupported":
+            return input.content;
+        default: {
+            const _exhaustive = input.mode;
+            void _exhaustive;
+            return input.content;
+        }
+    }
+}
+function targetHasHash(content, hash, mode) {
+    if (mode === "native-skill") {
+        return hashContent(content.replace(/\n?$/, "\n")) === hash;
+    }
+    const match = SKILL_HASH_PATTERN.exec(content);
+    return match?.[1] === hash;
+}
+async function readExistingSkillConfig(configPath) {
+    const raw = await readUtf8IfExists(configPath);
+    if (raw === null) {
+        return { selectedIds: [] };
+    }
+    try {
+        const parsed = parseYaml(raw);
+        if (!isRecord(parsed) || !isRecord(parsed.skills) || !isRecord(parsed.skills.selected)) {
+            return { selectedIds: [] };
+        }
+        return { selectedIds: Object.keys(parsed.skills.selected) };
+    }
+    catch {
+        return { selectedIds: [] };
+    }
+}
+async function readSkillDir(root, source) {
+    if (!(await pathExists(root))) {
+        return [];
+    }
+    const entries = await readdir(root, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const skillId = normalizeSkillId(entry.name);
+        if (!skillId) {
+            continue;
+        }
+        const skillPath = join(root, entry.name, "SKILL.md");
+        const content = await readUtf8IfExists(skillPath);
+        if (!content) {
+            continue;
+        }
+        skills.push(parseSkillContent(skillId, content, skillPath, source));
+    }
+    return skills;
+}
+function parseSkillContent(id, content, path, source) {
+    const frontmatter = /^---\n([\s\S]*?)\n---\n?/.exec(normalizeNewlines(content));
+    let name = id;
+    let description = `Synced project skill ${id}`;
+    if (frontmatter) {
+        try {
+            const parsed = parseYaml(frontmatter[1]);
+            if (isRecord(parsed)) {
+                if (typeof parsed.name === "string" && parsed.name.trim()) {
+                    name = parsed.name.trim();
+                }
+                if (typeof parsed.description === "string" && parsed.description.trim()) {
+                    description = parsed.description.trim();
+                }
+            }
+        }
+        catch {
+            // Invalid skill frontmatter should not stop setup from repairing other surfaces.
+        }
+    }
+    return { id, name, description, path, source, content: normalizeNewlines(content) };
+}
+function stripFrontmatter(content) {
+    return normalizeNewlines(content).replace(/^---\n[\s\S]*?\n---\n?/, "");
+}
+function buildTargetConfig(projectRoot) {
+    return Object.fromEntries(SUPPORTED_TOOLS.map((tool) => [
+        tool.id,
+        {
+            mode: tool.skillSync?.mode ?? "unsupported",
+            path: tool.skillSync?.targetPath
+                ? toProjectRelative(projectRoot, tool.skillSync.targetPath(projectRoot, BUILT_IN_SKILL_ID))
+                : undefined,
+        },
+    ]));
+}
+async function listCanonicalSkillIds(sourceDir) {
+    const entries = await readSkillDir(sourceDir, "xtctx");
+    return entries.map((entry) => entry.id);
+}
+function builtInHandoffSkill() {
+    return [
+        "---",
+        "name: xtctx-handoff",
+        "description: Retrieve cross-tool handoff context with xtctx MCP when starting work in a project configured by xtctx. Use when switching AI coding tools, resuming work from another agent, or needing recent local transcript context.",
+        "---",
+        "",
+        "# xtctx Handoff",
+        "",
+        "Use the xtctx MCP tools to retrieve recent local transcript context for this project.",
+        "",
+        "## Workflow",
+        "",
+        "1. Call `xtctx_recent_sessions` to list recent sessions for the current project.",
+        "2. Call `xtctx_session_detail` with a relevant `session_ref` before continuing the work.",
+        "3. Call `xtctx_search_sessions` when keyword or semantic search is more useful than recency.",
+        "4. Use `xtctx_continuity_status` only for wiring, cache, and freshness diagnostics.",
+        "",
+        "Raw transcript files remain authoritative. Do not invent a summary when raw detail is available.",
+        "",
+    ].join("\n");
+}
+function skillSourceDir(projectRoot) {
+    return join(projectRoot, ".xtctx", "skills");
+}
+function hashContent(content) {
+    return `${HASH_PREFIX}${createHash("sha256").update(normalizeNewlines(content).trimEnd() + "\n").digest("hex")}`;
+}
+async function writeIfChanged(filePath, content) {
+    const normalized = normalizeNewlines(content);
+    const existing = await readUtf8IfExists(filePath);
+    if (existing !== null && normalizeNewlines(existing) === normalized) {
+        return false;
+    }
+    await writeFileAtomic(filePath, normalized);
+    return true;
+}
+async function removePath(path) {
+    if (!(await pathExists(path))) {
+        return false;
+    }
+    await rm(path, { force: true });
+    return true;
+}
+async function readUtf8IfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function quoteYamlString(value) {
+    return JSON.stringify(value);
+}
+function normalizeSkillId(value) {
+    const normalized = value.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "");
+    return normalized.length > 0 ? normalized : null;
+}
+function uniqueIds(ids) {
+    return [...new Set(ids.map(normalizeSkillId).filter((id) => Boolean(id)))];
+}
+function toProjectRelative(projectRoot, path) {
+    const rel = relative(projectRoot, path);
+    if (!rel.startsWith("..")) {
+        return toPosixPath(rel);
+    }
+    return toPosixPath(path);
+}
+function toPosixPath(path) {
+    return path.replace(/\\/g, "/");
+}
+function normalizeNewlines(input) {
+    return input.replace(/\r\n/g, "\n");
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=skills.js.map

package/dist/src/config/skills.js.map

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

package/dist/src/handoff/embeddings.d.ts

@@ -0,0 +1,26 @@
+export declare const DEFAULT_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
+export interface EmbeddingProvider {
+    readonly model: string;
+    embed(text: string): Promise<Float32Array>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+}
+export declare class TransformersEmbeddingProvider implements EmbeddingProvider {
+    readonly model: string;
+    private extractor;
+    constructor(model?: string);
+    embed(text: string): Promise<Float32Array>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+    private getExtractor;
+}
+/**
+ * Split text into segments that fit the embedding model's sequence window
+ * (~4 chars per token; the default 1000 chars stays under 256 tokens).
+ * Splits on line boundaries; a single oversized line is hard-sliced.
+ */
+export declare function splitTextForEmbedding(text: string, maxChars?: number): string[];
+/**
+ * Mean-pool segment vectors into one unit vector, re-normalized to unit
+ * length so cosine scores stay comparable with single-segment vectors.
+ */
+export declare function poolVectors(vectors: Float32Array[]): Float32Array;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/src/handoff/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/handoff/embeddings.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAMjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtD;AAiBD,qBAAa,6BAA8B,YAAW,iBAAiB;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,SAAS,CAA0C;gBAE/C,KAAK,SAA0B;IAIrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAK1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAe5C,YAAY;CAuB3B;AA0BD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAgB,GAAG,MAAM,EAAE,CAgCtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,CAyBjE"}

package/dist/src/handoff/embeddings.js

@@ -0,0 +1,132 @@
+export const DEFAULT_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2";
+const MAX_SEQ_TOKENS = 256;
+/** ~4 characters per token, the budget splitTextForEmbedding segments to. */
+const MAX_SEQ_CHARS = MAX_SEQ_TOKENS * 4;
+const MAX_BATCH_SIZE = 32;
+export class TransformersEmbeddingProvider {
+    model;
+    extractor = null;
+    constructor(model = DEFAULT_EMBEDDING_MODEL) {
+        this.model = model;
+    }
+    async embed(text) {
+        const [vector] = await this.embedBatch([text]);
+        return vector;
+    }
+    async embedBatch(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const extractor = await this.getExtractor();
+        const vectors = [];
+        for (let start = 0; start < texts.length; start += MAX_BATCH_SIZE) {
+            const batch = texts.slice(start, start + MAX_BATCH_SIZE);
+            const output = await extractor(batch, { pooling: "mean", normalize: true });
+            vectors.push(...splitBatchOutput(output, batch.length));
+        }
+        return vectors;
+    }
+    async getExtractor() {
+        if (this.extractor) {
+            return this.extractor;
+        }
+        process.stderr.write(`xtctx: Initializing local embedding provider (${this.model})...\n`);
+        const transformers = (await import("@huggingface/transformers"));
+        const extractor = await transformers.pipeline("feature-extraction", this.model, {
+            dtype: "fp32",
+        });
+        // `model_max_length` is a getter with no setter in @huggingface/transformers,
+        // so assigning it threw a TypeError on every embed call under ESM's strict
+        // mode — semantic search failed for every user while hybrid mode silently
+        // degraded to keyword-only. Callers segment input to MAX_SEQ_TOKENS via
+        // splitTextForEmbedding before it reaches the model, and the model's own
+        // 512-token limit is the backstop, so nothing needs to be set here.
+        this.extractor = extractor;
+        return extractor;
+    }
+}
+function splitBatchOutput(output, batchSize) {
+    const flat = toFloat32Array(output.data);
+    const dimension = flat.length / batchSize;
+    if (!Number.isInteger(dimension) || dimension <= 0) {
+        throw new Error("Embedding model returned an unexpected output shape");
+    }
+    const vectors = [];
+    for (let index = 0; index < batchSize; index += 1) {
+        vectors.push(flat.slice(index * dimension, (index + 1) * dimension));
+    }
+    return vectors;
+}
+function toFloat32Array(data) {
+    if (data instanceof Float32Array) {
+        return data;
+    }
+    return Float32Array.from(data);
+}
+/**
+ * Split text into segments that fit the embedding model's sequence window
+ * (~4 chars per token; the default 1000 chars stays under 256 tokens).
+ * Splits on line boundaries; a single oversized line is hard-sliced.
+ */
+export function splitTextForEmbedding(text, maxChars = MAX_SEQ_CHARS) {
+    if (text.length <= maxChars) {
+        return [text];
+    }
+    const segments = [];
+    let current = "";
+    for (const line of text.split("\n")) {
+        if (line.length > maxChars) {
+            if (current) {
+                segments.push(current);
+                current = "";
+            }
+            for (let start = 0; start < line.length; start += maxChars) {
+                segments.push(line.slice(start, start + maxChars));
+            }
+            continue;
+        }
+        if (!current) {
+            current = line;
+        }
+        else if (current.length + 1 + line.length <= maxChars) {
+            current = `${current}\n${line}`;
+        }
+        else {
+            segments.push(current);
+            current = line;
+        }
+    }
+    if (current) {
+        segments.push(current);
+    }
+    return segments;
+}
+/**
+ * Mean-pool segment vectors into one unit vector, re-normalized to unit
+ * length so cosine scores stay comparable with single-segment vectors.
+ */
+export function poolVectors(vectors) {
+    if (vectors.length === 1) {
+        return vectors[0];
+    }
+    const dimensions = vectors[0]?.length ?? 0;
+    const pooled = new Float32Array(dimensions);
+    for (const vector of vectors) {
+        for (let index = 0; index < dimensions; index += 1) {
+            pooled[index] += vector[index];
+        }
+    }
+    let norm = 0;
+    for (let index = 0; index < dimensions; index += 1) {
+        pooled[index] /= vectors.length;
+        norm += pooled[index] * pooled[index];
+    }
+    if (norm > 0) {
+        const scale = 1 / Math.sqrt(norm);
+        for (let index = 0; index < dimensions; index += 1) {
+            pooled[index] *= scale;
+        }
+    }
+    return pooled;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/src/handoff/embeddings.js.map

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