silas 0.1.0 → 0.2.0

package/README.md

@@ -58,7 +58,7 @@ silas cache clear -y # Delete all cached data
 Start the Model Context Protocol server for integration with Claude and other AI assistants:
 
 ```bash
-silas serve
+silas mcp
 ```
 
 ## Supported Ecosystems
@@ -71,14 +71,13 @@ silas serve
 
 ## Configuration
 
-Configuration is stored at `~/.config/shelf/config.yaml`:
+Configuration is stored at `~/.config/silas/config.json`:
 
-```yaml
-cache:
-  maxSizeGb: 10
-
-agent:
-  type: claude-code  # or: codex, aider, goose, custom
+```json
+{
+  "cache_max_gb": 10,
+  "agent": "claude-code"
+}
 ```
 
 ## License

package/dist/cli.js

@@ -39469,55 +39469,6 @@ var require_public_api = __commonJS((exports) => {
   exports.stringify = stringify;
 });
 
-// node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors, Alias, identity4, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist = __esm(() => {
-  composer = require_composer();
-  Document = require_Document();
-  Schema = require_Schema();
-  errors = require_errors();
-  Alias = require_Alias();
-  identity4 = require_identity();
-  Pair = require_Pair();
-  Scalar = require_Scalar();
-  YAMLMap = require_YAMLMap();
-  YAMLSeq = require_YAMLSeq();
-  cst = require_cst();
-  lexer = require_lexer();
-  lineCounter = require_line_counter();
-  parser = require_parser2();
-  publicApi = require_public_api();
-  visit = require_visit();
-  $Composer = composer.Composer;
-  $Document = Document.Document;
-  $Schema = Schema.Schema;
-  $YAMLError = errors.YAMLError;
-  $YAMLParseError = errors.YAMLParseError;
-  $YAMLWarning = errors.YAMLWarning;
-  $Alias = Alias.Alias;
-  $isAlias = identity4.isAlias;
-  $isCollection = identity4.isCollection;
-  $isDocument = identity4.isDocument;
-  $isMap = identity4.isMap;
-  $isNode = identity4.isNode;
-  $isPair = identity4.isPair;
-  $isScalar = identity4.isScalar;
-  $isSeq = identity4.isSeq;
-  $Pair = Pair.Pair;
-  $Scalar = Scalar.Scalar;
-  $YAMLMap = YAMLMap.YAMLMap;
-  $YAMLSeq = YAMLSeq.YAMLSeq;
-  $Lexer = lexer.Lexer;
-  $LineCounter = lineCounter.LineCounter;
-  $Parser = parser.Parser;
-  $parse = publicApi.parse;
-  $parseAllDocuments = publicApi.parseAllDocuments;
-  $parseDocument = publicApi.parseDocument;
-  $stringify = publicApi.stringify;
-  $visit = visit.visit;
-  $visitAsync = visit.visitAsync;
-});
-
 // node_modules/effect/dist/esm/Secret.js
 var fromString4;
 var init_Secret = __esm(() => {
@@ -70318,7 +70269,7 @@ var init_errors2 = __esm(() => {
 });
 
 // src/config/config.ts
-var Agent, LogLevel, ConfigFile, ShelfConfigSchema, parseEnvAgent = (value6) => {
+var Agent, LogLevel, ConfigFile, SilasConfigSchema, parseEnvAgent = (value6) => {
   if (!value6)
     return;
   const valid = ["claude-code", "codex", "aider", "goose", "custom"];
@@ -70328,17 +70279,17 @@ var Agent, LogLevel, ConfigFile, ShelfConfigSchema, parseEnvAgent = (value6) =>
     return;
   const valid = ["debug", "info", "warn", "error"];
   return valid.includes(value6) ? value6 : undefined;
-}, parseYaml = (schema) => (content) => exports_Effect.gen(function* () {
+}, parseJson2 = (schema) => (content) => exports_Effect.gen(function* () {
   const parsed = yield* exports_Effect.try({
-    try: () => $parse(content),
-    catch: (e) => new Error(`YAML parse error: ${e}`)
+    try: () => JSON.parse(content),
+    catch: (e) => new Error(`JSON parse error: ${e}`)
   });
   return yield* exports_Schema.decodeUnknown(schema)(parsed ?? {}).pipe(exports_Effect.mapError((e) => new Error(`Schema validation error: ${e}`)));
 }), loadConfigFile = (fs, configPath) => fs.exists(configPath).pipe(exports_Effect.flatMap((exists4) => {
   if (!exists4) {
     return exports_Effect.logDebug("No config file found, using defaults", { configPath }).pipe(exports_Effect.map(() => ({})));
   }
-  return fs.readFileString(configPath).pipe(exports_Effect.flatMap(parseYaml(ConfigFile)));
+  return fs.readFileString(configPath).pipe(exports_Effect.flatMap(parseJson2(ConfigFile)));
 }), exports_Effect.tapError((e) => exports_Effect.logWarning("Failed to parse config file, using defaults", {
   configPath,
   error: String(e)
@@ -70347,15 +70298,14 @@ var Agent, LogLevel, ConfigFile, ShelfConfigSchema, parseEnvAgent = (value6) =>
   const xdgConfigHome = process.env["XDG_CONFIG_HOME"];
   const xdgCacheHome = process.env["XDG_CACHE_HOME"];
   const xdgStateHome = process.env["XDG_STATE_HOME"];
-  const configDir = xdgConfigHome ? pathService.join(xdgConfigHome, "shelf") : pathService.join(homeDir, ".config", "shelf");
-  const cacheDir = xdgCacheHome ? pathService.join(xdgCacheHome, "shelf") : pathService.join(homeDir, ".cache", "shelf");
-  const stateDir = xdgStateHome ? pathService.join(xdgStateHome, "shelf") : pathService.join(homeDir, ".local", "state", "shelf");
+  const configDir = xdgConfigHome ? pathService.join(xdgConfigHome, "silas") : pathService.join(homeDir, ".config", "silas");
+  const cacheDir = xdgCacheHome ? pathService.join(xdgCacheHome, "silas") : pathService.join(homeDir, ".cache", "silas");
+  const stateDir = xdgStateHome ? pathService.join(xdgStateHome, "silas") : pathService.join(homeDir, ".local", "state", "silas");
   return { configDir, cacheDir, stateDir };
 }, Config2;
 var init_config3 = __esm(() => {
   init_esm3();
   init_esm4();
-  init_dist();
   init_errors2();
   Agent = exports_Schema.Literal("claude-code", "codex", "aider", "goose", "custom");
   LogLevel = exports_Schema.Literal("debug", "info", "warn", "error");
@@ -70367,10 +70317,10 @@ var init_config3 = __esm(() => {
     cache_max_gb: exports_Schema.optional(exports_Schema.Number),
     log_level: exports_Schema.optional(LogLevel)
   });
-  ShelfConfigSchema = exports_Schema.Struct({
+  SilasConfigSchema = exports_Schema.Struct({
     agent: Agent,
     model: exports_Schema.String,
-    customCommand: exports_Schema.optional(exports_Schema.String),
+    customCommand: exports_Schema.UndefinedOr(exports_Schema.String),
     timeout: exports_Schema.Number,
     cacheMaxGb: exports_Schema.Number,
     logLevel: LogLevel,
@@ -70378,18 +70328,18 @@ var init_config3 = __esm(() => {
     cacheDir: exports_Schema.String,
     stateDir: exports_Schema.String
   });
-  Config2 = class Config2 extends exports_Context.Tag("@shelf/Config")() {
+  Config2 = class Config2 extends exports_Context.Tag("@silas/Config")() {
     static layer = exports_Layer.effect(Config2, exports_Effect.gen(function* () {
       const fs = yield* exports_FileSystem.FileSystem;
       const path4 = yield* exports_Path.Path;
       const { configDir, cacheDir, stateDir } = getDirectories(path4);
-      const configPath = path4.join(configDir, "config.yaml");
+      const configPath = path4.join(configDir, "config.json");
       const fileConfig = yield* loadConfigFile(fs, configPath);
-      const envAgent = process.env["SHELF_AGENT"];
-      const envModel = process.env["SHELF_MODEL"];
-      const envTimeout = process.env["SHELF_TIMEOUT"];
-      const envCacheMaxGb = process.env["SHELF_CACHE_MAX_GB"];
-      const envLogLevel = process.env["SHELF_LOG_LEVEL"];
+      const envAgent = process.env["SILAS_AGENT"];
+      const envModel = process.env["SILAS_MODEL"];
+      const envTimeout = process.env["SILAS_TIMEOUT"];
+      const envCacheMaxGb = process.env["SILAS_CACHE_MAX_GB"];
+      const envLogLevel = process.env["SILAS_LOG_LEVEL"];
       const agent = parseEnvAgent(envAgent) ?? fileConfig.agent ?? "claude-code";
       const model = envModel ?? fileConfig.model ?? "claude-sonnet-4-20250514";
       const customCommand = fileConfig.custom_command;
@@ -70407,7 +70357,7 @@ var init_config3 = __esm(() => {
         cacheDir,
         stateDir
       };
-      const validated = yield* exports_Schema.decodeUnknown(ShelfConfigSchema)(candidate).pipe(exports_Effect.mapError((e) => ConfigError.make({
+      const validated = yield* exports_Schema.decodeUnknown(SilasConfigSchema)(candidate).pipe(exports_Effect.mapError((e) => ConfigError.make({
         message: `Invalid configuration: ${e}`
       })));
       return Config2.of(validated);
@@ -70419,9 +70369,9 @@ var init_config3 = __esm(() => {
       timeout: 10,
       cacheMaxGb: 1,
       logLevel: "debug",
-      configDir: "/tmp/shelf/config",
-      cacheDir: "/tmp/shelf/cache",
-      stateDir: "/tmp/shelf/state",
+      configDir: "/tmp/silas/config",
+      cacheDir: "/tmp/silas/cache",
+      stateDir: "/tmp/silas/state",
       ...overrides
     }));
   };
@@ -70434,7 +70384,7 @@ var RequestId, currentRequestId, withRequestId = (effect3) => exports_Effect.gen
 });
 var init_request_id = __esm(() => {
   init_esm3();
-  RequestId = class RequestId extends exports_Context.Tag("@shelf/RequestId")() {
+  RequestId = class RequestId extends exports_Context.Tag("@silas/RequestId")() {
     static generate = exports_Effect.try({
       try: () => {
         const bytes = new Uint8Array(4);
@@ -70460,7 +70410,7 @@ var levelPriority, writeLogEntry = (fs, logsDir, getLogFile, entry) => fs.makeDi
   const line4 = JSON.stringify(entry) + `
 `;
   return fs.writeFileString(logFile, line4, { flag: "a" });
-}), exports_Effect.catchAll((e) => exports_Effect.sync(() => console.error(`[shelf:logger] Failed to write log: ${e}`)))), pruneOldLogs = (fs, pathService, logsDir, cutoffDays) => fs.exists(logsDir).pipe(exports_Effect.flatMap((exists4) => {
+}), exports_Effect.catchAll((e) => exports_Effect.sync(() => console.error(`[silas:logger] Failed to write log: ${e}`)))), pruneOldLogs = (fs, pathService, logsDir, cutoffDays) => fs.exists(logsDir).pipe(exports_Effect.flatMap((exists4) => {
   if (!exists4)
     return exports_Effect.void;
   return fs.readDirectory(logsDir).pipe(exports_Effect.flatMap((files) => {
@@ -70472,7 +70422,7 @@ var levelPriority, writeLogEntry = (fs, logsDir, getLogFile, entry) => fs.makeDi
     }).map((file6) => fs.remove(pathService.join(logsDir, file6)));
     return exports_Effect.all(removeEffects, { concurrency: "unbounded" });
   }), exports_Effect.asVoid);
-}), exports_Effect.tapError((e) => exports_Effect.sync(() => console.error(`[shelf:logger] Failed to prune old logs: ${e}`))), exports_Effect.catchAll(() => exports_Effect.void)), Logger;
+}), exports_Effect.tapError((e) => exports_Effect.sync(() => console.error(`[silas:logger] Failed to prune old logs: ${e}`))), exports_Effect.catchAll(() => exports_Effect.void)), Logger;
 var init_logger2 = __esm(() => {
   init_esm3();
   init_esm4();
@@ -70484,7 +70434,7 @@ var init_logger2 = __esm(() => {
     warn: 2,
     error: 3
   };
-  Logger = class Logger extends exports_Context.Tag("@shelf/Logger")() {
+  Logger = class Logger extends exports_Context.Tag("@silas/Logger")() {
     static layer = exports_Layer.effect(Logger, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const fs = yield* exports_FileSystem.FileSystem;
@@ -70509,7 +70459,7 @@ var init_logger2 = __esm(() => {
           ...fields
         };
         yield* writeLogEntry(fs, logsDir, getLogFile, entry);
-        const stderrLine = `[shelf:${requestId}] ${message}`;
+        const stderrLine = `[silas:${requestId}] ${message}`;
         yield* exports_Effect.sync(() => console.error(stderrLine));
       });
       yield* pruneOldLogs(fs, path4, logsDir, 30);
@@ -70643,7 +70593,7 @@ var init_git = __esm(() => {
   init_errors2();
   init_spawn();
   init_logger2();
-  Git = class Git extends exports_Context.Tag("@shelf/Git")() {
+  Git = class Git extends exports_Context.Tag("@silas/Git")() {
     static layer = exports_Layer.effect(Git, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const pathService = yield* exports_Path.Path;
@@ -70726,7 +70676,7 @@ var init_lock = __esm(() => {
   init_config3();
   init_errors2();
   init_logger2();
-  Lock = class Lock extends exports_Context.Tag("@shelf/Lock")() {
+  Lock = class Lock extends exports_Context.Tag("@silas/Lock")() {
     static layer = exports_Layer.effect(Lock, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const pathService = yield* exports_Path.Path;
@@ -70810,7 +70760,7 @@ var init_checkout = __esm(() => {
     branch: exports_Schema.optional(exports_Schema.String)
   });
   CheckoutMetaFromJson = exports_Schema.parseJson(CheckoutMeta);
-  Checkout = class Checkout extends exports_Context.Tag("@shelf/Checkout")() {
+  Checkout = class Checkout extends exports_Context.Tag("@silas/Checkout")() {
     static layer = exports_Layer.effect(Checkout, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const fs = yield* exports_FileSystem.FileSystem;
@@ -70937,7 +70887,7 @@ var init_cache2 = __esm(() => {
   init_cache_meta();
   init_spawn();
   init_logger2();
-  Cache = class Cache extends exports_Context.Tag("@shelf/Cache")() {
+  Cache = class Cache extends exports_Context.Tag("@silas/Cache")() {
     static layer = exports_Layer.effect(Cache, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const fs = yield* exports_FileSystem.FileSystem;
@@ -71080,7 +71030,7 @@ var init_ref_resolver = __esm(() => {
   init_git();
   init_errors2();
   init_logger2();
-  RefResolver = class RefResolver extends exports_Context.Tag("@shelf/RefResolver")() {
+  RefResolver = class RefResolver extends exports_Context.Tag("@silas/RefResolver")() {
     static layer = exports_Layer.effect(RefResolver, exports_Effect.gen(function* () {
       const git = yield* Git;
       const logger3 = yield* Logger;
@@ -71295,7 +71245,7 @@ var init_pypi = __esm(() => {
 var resolveCargo = (packageName, version) => {
   const url2 = `https://crates.io/api/v1/crates/${packageName}`;
   return fetchRegistry(url2, packageName, "cargo", CargoRegistryResponseSchema, {
-    "User-Agent": "shelf/1.0"
+    "User-Agent": "silas/1.0"
   }).pipe(exports_Effect.flatMap((data) => {
     const resolvedVersion = version ?? data.crate?.newest_version;
     if (!resolvedVersion) {
@@ -71500,7 +71450,7 @@ var init_package_resolver = __esm(() => {
   init_esm3();
   init_resolvers();
   ECOSYSTEMS = ["npm", "pypi", "cargo", "go", "rubygems"];
-  PackageResolver = class PackageResolver extends exports_Context.Tag("@shelf/PackageResolver")() {
+  PackageResolver = class PackageResolver extends exports_Context.Tag("@silas/PackageResolver")() {
     static layer = exports_Layer.succeed(PackageResolver, PackageResolver.of({
       resolve: exports_Effect.fn("PackageResolver.resolve")(function* (ecosystem, packageName, version) {
         return yield* resolvers[ecosystem](packageName, version);
@@ -71613,7 +71563,7 @@ var init_agent = __esm(() => {
   init_config3();
   init_errors2();
   init_spawn();
-  Agent2 = class Agent2 extends exports_Context.Tag("@shelf/Agent")() {
+  Agent2 = class Agent2 extends exports_Context.Tag("@silas/Agent")() {
     static layer = exports_Layer.effect(Agent2, exports_Effect.gen(function* () {
       const config2 = yield* Config2;
       const invoke = exports_Effect.fn("Agent.invoke")(function* (workingDir, context8) {
@@ -100624,7 +100574,7 @@ var init_mcp2 = __esm(() => {
   init_ask();
   init_request_id();
   server = new McpServer({
-    name: "shelf",
+    name: "silas",
     version: "0.1.0"
   });
   server.tool("ask_library", `Answer questions about a published library by fetching and analyzing its source code, documentation, and API.
@@ -100751,7 +100701,7 @@ Be specific. For large repositories, mention which part of the codebase you're i
       try: () => server.connect(transport),
       catch: (error51) => new Error(`Failed to connect MCP server: ${error51}`)
     });
-    yield* exports_Console.error("shelf MCP server started");
+    yield* exports_Console.error("silas MCP server started");
   });
   if (false) {}
 });
@@ -100816,9 +100766,56 @@ init_Ref();
 // node_modules/@effect/cli/dist/esm/internal/files.js
 init_FileSystem();
 init_Effect();
-init_dist();
 var Ini = __toESM(require_ini(), 1);
 var Toml = __toESM(require_toml(), 1);
+
+// node_modules/yaml/dist/index.js
+var composer = require_composer();
+var Document = require_Document();
+var Schema = require_Schema();
+var errors = require_errors();
+var Alias = require_Alias();
+var identity4 = require_identity();
+var Pair = require_Pair();
+var Scalar = require_Scalar();
+var YAMLMap = require_YAMLMap();
+var YAMLSeq = require_YAMLSeq();
+var cst = require_cst();
+var lexer = require_lexer();
+var lineCounter = require_line_counter();
+var parser = require_parser2();
+var publicApi = require_public_api();
+var visit = require_visit();
+var $Composer = composer.Composer;
+var $Document = Document.Document;
+var $Schema = Schema.Schema;
+var $YAMLError = errors.YAMLError;
+var $YAMLParseError = errors.YAMLParseError;
+var $YAMLWarning = errors.YAMLWarning;
+var $Alias = Alias.Alias;
+var $isAlias = identity4.isAlias;
+var $isCollection = identity4.isCollection;
+var $isDocument = identity4.isDocument;
+var $isMap = identity4.isMap;
+var $isNode = identity4.isNode;
+var $isPair = identity4.isPair;
+var $isScalar = identity4.isScalar;
+var $isSeq = identity4.isSeq;
+var $Pair = Pair.Pair;
+var $Scalar = Scalar.Scalar;
+var $YAMLMap = YAMLMap.YAMLMap;
+var $YAMLSeq = YAMLSeq.YAMLSeq;
+var $Lexer = lexer.Lexer;
+var $LineCounter = lineCounter.LineCounter;
+var $Parser = parser.Parser;
+var $parse = publicApi.parse;
+var $parseAllDocuments = publicApi.parseAllDocuments;
+var $parseDocument = publicApi.parseDocument;
+var $stringify = publicApi.stringify;
+var $visit = visit.visit;
+var $visitAsync = visit.visitAsync;
+
+// node_modules/@effect/cli/dist/esm/internal/files.js
 var fileParsers = {
   json: (content) => JSON.parse(content),
   yaml: (content) => $parse(content),
@@ -107930,16 +107927,16 @@ var cacheClearCommand = exports_Command.make("clear", { yes: yesOpt }, ({ yes })
   yield* exports_Console.log("Cache cleared");
 })).pipe(exports_Command.withDescription("Delete all cached data"));
 var cacheCommand = exports_Command.make("cache").pipe(exports_Command.withSubcommands([cacheStatusCommand, cachePruneCommand, cacheClearCommand]), exports_Command.withDescription("Manage the local cache"));
-var serveCommand = exports_Command.make("serve", {}, () => exports_Effect.gen(function* () {
-  const mcp = yield* exports_Effect.tryPromise({
+var mcpCommand = exports_Command.make("mcp", {}, () => exports_Effect.gen(function* () {
+  const mcpModule = yield* exports_Effect.tryPromise({
     try: () => Promise.resolve().then(() => (init_mcp2(), exports_mcp)),
     catch: (error51) => ValidationError.make({
       message: `Failed to load MCP module: ${error51}`
     })
   });
-  yield* mcp.startServer;
+  yield* mcpModule.startServer;
 })).pipe(exports_Command.withDescription("Start the MCP server"));
-var mainCommand = exports_Command.make("silas").pipe(exports_Command.withSubcommands([askCommand, resolveCommand, cacheCommand, serveCommand]), exports_Command.withDescription("Answer questions about library source code"));
+var mainCommand = exports_Command.make("silas").pipe(exports_Command.withSubcommands([askCommand, resolveCommand, cacheCommand, mcpCommand]), exports_Command.withDescription("Answer questions about library source code"));
 var cli = exports_Command.run(mainCommand, {
   name: "silas",
   version: "0.1.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silas",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI and MCP server for answering questions about library source code",
   "author": "David Turnbull",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "prepare": "effect-language-service patch",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
-    "shelf": "bun src/cli.ts",
+    "silas": "bun src/cli.ts",
     "build": "bun build src/cli.ts --target=node --outdir=dist --entry-naming=[name].js && bun run build:shebang",
     "build:shebang": "echo '#!/usr/bin/env node' | cat - dist/cli.js > dist/cli.tmp && mv dist/cli.tmp dist/cli.js",
     "prepublishOnly": "bun run build"
@@ -45,7 +45,6 @@
     "@effect/rpc": "latest",
     "@effect/sql": "latest",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "effect": "latest",
-    "yaml": "^2.8.2"
+    "effect": "latest"
   }
 }