xtctx 0.3.2

package/dist/src/api/server.d.ts

@@ -0,0 +1,26 @@
+import express from "express";
+import { createServer } from "node:http";
+export interface ApiServerOptions {
+    projectPath?: string;
+    port?: number;
+    webStaticDir?: string;
+    security?: Partial<ApiSecurityOptions>;
+}
+export interface ApiSecurityOptions {
+    apiToken: string | null;
+    allowedOrigins: string[];
+    allowLocalhostOrigins: boolean;
+    rateLimitWindowMs: number;
+    rateLimitMax: number;
+}
+export interface ApiServerHandle {
+    app: express.Express;
+    server: ReturnType<typeof createServer>;
+    port: number;
+}
+export declare function createApiApp(projectPath?: string, options?: Pick<ApiServerOptions, "webStaticDir" | "security">): Promise<{
+    app: express.Express;
+    port: number;
+}>;
+export declare function startApiServer(options?: ApiServerOptions): Promise<ApiServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/api/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/api/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAWzC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,UAAU,CAAM,GAChE,OAAO,CAAC;IACT,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CA2GD;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiB7F"}

package/dist/src/api/server.js

@@ -0,0 +1,312 @@
+import express from "express";
+import { timingSafeEqual } from "node:crypto";
+import { stat } from "node:fs/promises";
+import { createServer } from "node:http";
+import { dirname, extname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import rateLimit from "express-rate-limit";
+import helmet from "helmet";
+import { createConfigRouter } from "./routes/config.js";
+import { createKnowledgeRouter } from "./routes/knowledge.js";
+import { createSearchRouter } from "./routes/search.js";
+import { createSourcesRouter } from "./routes/sources.js";
+import { createProjectServices } from "../runtime/services.js";
+export async function createApiApp(projectPath, options = {}) {
+    const services = await createProjectServices(projectPath);
+    const webAssets = await resolveWebAssets(options.webStaticDir);
+    const security = resolveSecurityOptions(services.webPort, {
+        ...services.apiSecurity,
+        ...(options.security ?? {}),
+    });
+    const app = express();
+    app.disable("x-powered-by");
+    app.use(helmet({
+        contentSecurityPolicy: {
+            useDefaults: true,
+            directives: {
+                "default-src": ["'self'"],
+                "script-src": ["'self'"],
+                "style-src": ["'self'", "'unsafe-inline'"],
+                "img-src": ["'self'", "data:"],
+                "font-src": ["'self'", "data:"],
+                "connect-src": ["'self'"],
+                "base-uri": ["'none'"],
+                "frame-ancestors": ["'none'"],
+                "object-src": ["'none'"],
+                "upgrade-insecure-requests": null,
+            },
+        },
+        crossOriginEmbedderPolicy: false,
+    }));
+    app.use(express.json({ limit: "1mb" }));
+    app.use(createCorsMiddleware(security));
+    const apiLimiter = rateLimit({
+        windowMs: security.rateLimitWindowMs,
+        max: security.rateLimitMax,
+        standardHeaders: true,
+        legacyHeaders: false,
+        handler: (_req, res) => {
+            res.status(429).json({ error: "Too many requests. Please retry shortly." });
+        },
+    });
+    app.use("/api", apiLimiter);
+    app.use("/api", noStoreCacheMiddleware);
+    app.use("/api", createApiAuthMiddleware(security));
+    app.get("/health", (_req, res) => {
+        res.json({
+            ok: true,
+            service: "xtctx-api",
+            projectRoot: services.projectRoot,
+        });
+    });
+    const knowledgeRecords = async () => services.knowledge.listAll();
+    app.use("/api/search", createSearchRouter({ knowledgeRecords }));
+    app.use("/api/knowledge", createKnowledgeRouter(services.knowledge));
+    app.use("/api/sources", createSourcesRouter({
+        projectRoot: services.projectRoot,
+        knowledgeDir: services.knowledgeDir,
+        stateDir: services.stateDir,
+        sessions: services.sessions,
+        knowledgeRecords,
+    }));
+    app.use("/api/config", createConfigRouter(services.configs));
+    if (webAssets) {
+        app.use(express.static(webAssets.root, { index: false }));
+        app.get("/", (_req, res) => {
+            res.sendFile(webAssets.indexFile);
+        });
+        app.get("/{*path}", (req, res, next) => {
+            if (req.path === "/health" || req.path === "/api" || req.path.startsWith("/api/")) {
+                next();
+                return;
+            }
+            if (extname(req.path)) {
+                next();
+                return;
+            }
+            res.sendFile(webAssets.indexFile);
+        });
+    }
+    app.use((error, _req, res, _next) => {
+        const status = asHttpStatus(error);
+        const message = status >= 500
+            ? "Internal server error."
+            : error instanceof Error
+                ? error.message
+                : String(error);
+        if (status >= 500) {
+            console.error(`xtctx api error: ${errorMessage(error)}`);
+        }
+        res.status(status).json({ error: message });
+    });
+    return { app, port: services.webPort };
+}
+export async function startApiServer(options = {}) {
+    const { app, port: defaultPort } = await createApiApp(options.projectPath, {
+        webStaticDir: options.webStaticDir,
+        security: options.security,
+    });
+    const port = options.port ?? defaultPort;
+    const server = createServer(app);
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, "127.0.0.1", () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return { app, server, port };
+}
+async function runFromCli() {
+    const handle = await startApiServer();
+    console.log(`xtctx API listening on http://127.0.0.1:${handle.port}`);
+}
+const invokedPath = process.argv[1]
+    ? pathToFileURL(process.argv[1]).href
+    : "";
+if (import.meta.url === invokedPath) {
+    runFromCli().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(message);
+        process.exitCode = 1;
+    });
+}
+async function resolveWebAssets(webStaticDir) {
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const candidates = dedupePaths([
+        webStaticDir,
+        resolve(moduleDir, "..", "..", "..", "web", "dist"),
+        resolve(moduleDir, "..", "..", "..", "dist", "web"),
+        resolve(moduleDir, "..", "..", "web"),
+    ]);
+    for (const candidate of candidates) {
+        const indexFile = join(candidate, "index.html");
+        if (await isFile(indexFile)) {
+            return { root: candidate, indexFile };
+        }
+    }
+    return null;
+}
+async function isFile(path) {
+    try {
+        const result = await stat(path);
+        return result.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function dedupePaths(paths) {
+    return [...new Set(paths.filter((entry) => Boolean(entry)))];
+}
+function createCorsMiddleware(security) {
+    return (req, res, next) => {
+        const origin = req.headers.origin;
+        if (!origin) {
+            next();
+            return;
+        }
+        if (!isAllowedOrigin(origin, security)) {
+            res.status(403).json({ error: "Origin not allowed." });
+            return;
+        }
+        res.setHeader("Vary", "Origin");
+        res.setHeader("Access-Control-Allow-Origin", origin);
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, X-Xtctx-Api-Token");
+        res.setHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
+        if (req.method === "OPTIONS") {
+            res.status(204).end();
+            return;
+        }
+        next();
+    };
+}
+function createApiAuthMiddleware(security) {
+    return (req, res, next) => {
+        if (!security.apiToken || req.method === "OPTIONS") {
+            next();
+            return;
+        }
+        const candidate = extractToken(req);
+        if (!candidate || !safeTokenEqual(candidate, security.apiToken)) {
+            res.setHeader("WWW-Authenticate", "Bearer realm=\"xtctx-api\"");
+            res.status(401).json({ error: "Unauthorized." });
+            return;
+        }
+        next();
+    };
+}
+function extractToken(req) {
+    const authHeader = req.headers.authorization;
+    if (typeof authHeader === "string") {
+        const match = authHeader.match(/^Bearer\s+(.+)$/i);
+        if (match) {
+            return match[1];
+        }
+    }
+    const tokenHeader = req.headers["x-xtctx-api-token"];
+    if (typeof tokenHeader === "string") {
+        return tokenHeader;
+    }
+    return null;
+}
+function safeTokenEqual(candidate, expected) {
+    const candidateBuffer = Buffer.from(candidate);
+    const expectedBuffer = Buffer.from(expected);
+    if (candidateBuffer.length !== expectedBuffer.length) {
+        return false;
+    }
+    return timingSafeEqual(candidateBuffer, expectedBuffer);
+}
+function isAllowedOrigin(origin, security) {
+    if (security.allowedOrigins.includes(origin)) {
+        return true;
+    }
+    if (security.allowLocalhostOrigins) {
+        return /^https?:\/\/(localhost|127\.0\.0\.1|\[::1\])(:\d+)?$/i.test(origin);
+    }
+    return false;
+}
+const noStoreCacheMiddleware = (_req, res, next) => {
+    res.setHeader("Cache-Control", "no-store");
+    next();
+};
+function resolveSecurityOptions(port, overrides) {
+    const envOrigins = splitCsv(process.env.XTCTX_ALLOWED_ORIGINS);
+    const defaultOrigins = [`http://127.0.0.1:${port}`, `http://localhost:${port}`];
+    const allowedOrigins = dedupePaths([
+        ...(overrides?.allowedOrigins ?? []),
+        ...envOrigins,
+        ...defaultOrigins,
+    ]);
+    const localhostOriginDefault = overrides?.allowLocalhostOrigins ?? false;
+    const allowLocalhostOrigins = process.env.XTCTX_ALLOW_LOCALHOST_ORIGINS == null
+        ? localhostOriginDefault
+        : parseBoolean(process.env.XTCTX_ALLOW_LOCALHOST_ORIGINS, localhostOriginDefault);
+    const apiToken = process.env.XTCTX_API_TOKEN == null
+        ? normalizeToken(overrides?.apiToken ?? null)
+        : normalizeToken(process.env.XTCTX_API_TOKEN);
+    return {
+        apiToken,
+        allowedOrigins,
+        allowLocalhostOrigins,
+        rateLimitWindowMs: sanitizePositiveInt(process.env.XTCTX_RATE_LIMIT_WINDOW_MS ?? overrides?.rateLimitWindowMs, 60_000),
+        rateLimitMax: sanitizePositiveInt(process.env.XTCTX_RATE_LIMIT_MAX ?? overrides?.rateLimitMax, 120),
+    };
+}
+function splitCsv(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function parseBoolean(value, fallback) {
+    if (value == null) {
+        return fallback;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "yes") {
+        return true;
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "no") {
+        return false;
+    }
+    return fallback;
+}
+function normalizeToken(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const token = value.trim();
+    return token.length > 0 ? token : null;
+}
+function sanitizePositiveInt(value, fallback) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed) && parsed > 0) {
+        return Math.floor(parsed);
+    }
+    return fallback;
+}
+function asHttpStatus(error) {
+    if (error && typeof error === "object") {
+        const status = Number(error.status);
+        if (Number.isInteger(status) && status >= 400 && status <= 599) {
+            return status;
+        }
+        const statusCode = Number(error.statusCode);
+        if (Number.isInteger(statusCode) && statusCode >= 400 && statusCode <= 599) {
+            return statusCode;
+        }
+    }
+    return 500;
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=server.js.map

package/dist/src/api/server.js.map

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

package/dist/src/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AASA,wBAAsB,IAAI,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD7D"}

package/dist/src/cli/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runIngest } from "./ingest.js";
+import { runInit } from "./init.js";
+import { runServe } from "./serve.js";
+import { runSync } from "./sync.js";
+const CLI_VERSION = "0.1.0";
+export async function main(argv = process.argv) {
+    const program = new Command();
+    program
+        .name("xtctx")
+        .description("Cross-tool context for AI coding agents")
+        .version(CLI_VERSION);
+    program
+        .command("init")
+        .argument("[projectPath]", "Project root to initialize")
+        .option("-f, --force", "Overwrite existing xtctx config files", false)
+        .description("Scaffold .xtctx in the target project")
+        .action(async (projectPath, options) => {
+        await runInit({ projectPath, force: options.force });
+    });
+    program
+        .command("serve")
+        .option("-p, --project <path>", "Project root (defaults to cwd)")
+        .option("--mcp-only", "Only start MCP server (skip ingestion/web notices)", false)
+        .description("Start xtctx services (currently MCP server)")
+        .action(async (options) => {
+        await runServe({
+            projectPath: options.project,
+            mcpOnly: options.mcpOnly,
+        });
+    });
+    program
+        .command("sync")
+        .option("-p, --project <path>", "Project root (defaults to cwd)")
+        .description("Generate tool-native config files from shared config")
+        .action(async (options) => {
+        await runSync({ projectPath: options.project });
+    });
+    program
+        .command("ingest")
+        .option("-p, --project <path>", "Project root (defaults to cwd)")
+        .option("--full", "Run a full re-sync instead of incremental", false)
+        .description("Manually trigger ingestion")
+        .action(async (options) => {
+        await runIngest({
+            projectPath: options.project,
+            full: options.full,
+        });
+    });
+    await program.parseAsync(argv);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/src/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC5C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,WAAW,CAAC,yCAAyC,CAAC;SACtD,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,eAAe,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,aAAa,EAAE,uCAAuC,EAAE,KAAK,CAAC;SACrE,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,OAA2B,EAAE,EAAE;QAC7E,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,sBAAsB,EAAE,gCAAgC,CAAC;SAChE,MAAM,CAAC,YAAY,EAAE,oDAAoD,EAAE,KAAK,CAAC;SACjF,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,OAA+C,EAAE,EAAE;QAChE,MAAM,QAAQ,CAAC;YACb,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,MAAM,CAAC,sBAAsB,EAAE,gCAAgC,CAAC;SAChE,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,MAAM,CAAC,sBAAsB,EAAE,gCAAgC,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,2CAA2C,EAAE,KAAK,CAAC;SACpE,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAA4C,EAAE,EAAE;QAC7D,MAAM,SAAS,CAAC;YACd,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/src/cli/ingest.d.ts

@@ -0,0 +1,6 @@
+export interface IngestOptions {
+    projectPath?: string;
+    full?: boolean;
+}
+export declare function runIngest(options?: IngestOptions): Promise<void>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/src/cli/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/cli/ingest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1E"}

package/dist/src/cli/ingest.js

@@ -0,0 +1,11 @@
+import { createIngestionRuntime } from "../runtime/ingestion.js";
+import { createProjectServices } from "../runtime/services.js";
+export async function runIngest(options = {}) {
+    const services = await createProjectServices(options.projectPath);
+    const runtime = await createIngestionRuntime(services);
+    const result = options.full
+        ? await runtime.coordinator.fullSync()
+        : await runtime.coordinator.runCycle();
+    console.log(`Ingestion complete: ${result.processedChunks} chunks from ${result.processedScrapers} scraper(s).`);
+}
+//# sourceMappingURL=ingest.js.map

package/dist/src/cli/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/cli/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAO/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAyB,EAAE;IACzD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI;QACzB,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE;QACtC,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAEzC,OAAO,CAAC,GAAG,CACT,uBAAuB,MAAM,CAAC,eAAe,gBAAgB,MAAM,CAAC,iBAAiB,cAAc,CACpG,CAAC;AACJ,CAAC"}

package/dist/src/cli/init.d.ts

@@ -0,0 +1,6 @@
+export interface InitOptions {
+    projectPath?: string;
+    force?: boolean;
+}
+export declare function runInit(options?: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/init.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiED,wBAAsB,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCtE"}

package/dist/src/cli/init.js

@@ -0,0 +1,105 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+const DEFAULT_CONFIG_YAML = `version: "1"
+project:
+  name: ""
+  root: "."
+ingestion:
+  scrapers: []
+  watchPaths: []
+  pollIntervalMs: 30000
+  excludePatterns:
+    - node_modules/**
+    - dist/**
+compaction:
+  strategy: rule-based
+  sessionBoundaryMinutes: 30
+search:
+  defaultMode: hybrid
+  defaultDepth: summary
+  defaultLimit: 10
+domainTags: {}
+web:
+  port: 3232
+api:
+  security:
+    token: ""
+    allowedOrigins: []
+    allowLocalhostOrigins: false
+    rateLimitWindowMs: 60000
+    rateLimitMax: 120
+`;
+const DEFAULT_TOOL_CONFIG_YAML = `shared:
+  skills:
+    - xtctx-usage
+  commands: []
+  agents: []
+toolPreferences: {}
+`;
+const DEFAULT_XTCTX_USAGE_SKILL = `# xtctx-usage
+
+Use this workflow when xtctx tools are available through MCP.
+
+## Session Start
+
+1. Call \`xtctx_search\` with a summary query of the active task before making changes.
+2. Call \`xtctx_project_knowledge\` with \`type: all\` for prior decisions, fixes, and insights.
+3. Optionally call \`xtctx_recent_sessions\` and \`xtctx_session_detail\` when session data is available.
+
+## During Implementation
+
+1. Use \`xtctx_search\` first at \`depth: summary\`, then drill into \`detail\` only as needed.
+2. Use \`xtctx_list_configs\` and \`xtctx_get_config\` to load shared project rules.
+3. Use \`xtctx_tool_preferences\` for tool-specific behavior before acting.
+
+## Writeback Rules
+
+1. Save major architecture choices with \`xtctx_save_decision\`.
+2. Save recurring failures and verified fixes with \`xtctx_save_error_solution\`.
+3. Save durable learnings with \`xtctx_save_insight\`.
+4. Save recurring project Q&A with \`xtctx_save_faq\`.
+5. Keep records short, concrete, and tied to files, commands, and rationale.
+`;
+export async function runInit(options = {}) {
+    const projectRoot = resolve(options.projectPath ?? process.cwd());
+    const xtctxDir = join(projectRoot, ".xtctx");
+    const knowledgeDir = join(xtctxDir, "knowledge");
+    const configFile = join(xtctxDir, "config.yaml");
+    const toolConfigDir = join(xtctxDir, "tool-config");
+    const toolSkillsDir = join(toolConfigDir, "skills");
+    const toolCommandsDir = join(toolConfigDir, "commands");
+    const toolAgentsDir = join(toolConfigDir, "agents");
+    const toolConfigFile = join(toolConfigDir, "shared.yaml");
+    const xtctxUsageSkillFile = join(toolSkillsDir, "xtctx-usage.md");
+    const stateDir = join(xtctxDir, "state");
+    await mkdir(xtctxDir, { recursive: true });
+    await mkdir(knowledgeDir, { recursive: true });
+    await mkdir(join(knowledgeDir, "decisions"), { recursive: true });
+    await mkdir(join(knowledgeDir, "errors"), { recursive: true });
+    await mkdir(join(knowledgeDir, "insights"), { recursive: true });
+    await mkdir(join(knowledgeDir, "conventions"), { recursive: true });
+    await mkdir(join(knowledgeDir, "gotchas"), { recursive: true });
+    await mkdir(join(knowledgeDir, "faqs"), { recursive: true });
+    await mkdir(toolConfigDir, { recursive: true });
+    await mkdir(toolSkillsDir, { recursive: true });
+    await mkdir(toolCommandsDir, { recursive: true });
+    await mkdir(toolAgentsDir, { recursive: true });
+    await mkdir(stateDir, { recursive: true });
+    await writeIfMissing(configFile, DEFAULT_CONFIG_YAML, options.force ?? false);
+    await writeIfMissing(toolConfigFile, DEFAULT_TOOL_CONFIG_YAML, options.force ?? false);
+    await writeIfMissing(xtctxUsageSkillFile, DEFAULT_XTCTX_USAGE_SKILL, options.force ?? false);
+    console.log(`Initialized xtctx in ${xtctxDir}`);
+}
+async function writeIfMissing(filePath, content, force) {
+    if (!force) {
+        try {
+            await readFile(filePath, "utf-8");
+            return;
+        }
+        catch {
+            // File missing, continue with write.
+        }
+    }
+    await writeFile(filePath, content, "utf-8");
+}
+//# sourceMappingURL=init.js.map

package/dist/src/cli/init.js.map

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

package/dist/src/cli/serve.d.ts

@@ -0,0 +1,7 @@
+interface ServeOptions {
+    projectPath?: string;
+    mcpOnly?: boolean;
+}
+export declare function runServe(options?: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/src/cli/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/cli/serve.ts"],"names":[],"mappings":"AAWA,UAAU,YAAY;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFxE"}