@hasna/knowledge 0.2.2 → 0.2.4

package/SECURITY.md

@@ -1,39 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 0.1.x   | :white_check_mark: |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it responsibly.
-
-**Do not open a public GitHub issue** for security vulnerabilities.
-
-Please send details privately:
-
-1. **Email**: Send to the maintainer directly via GitHub.
-2. **GitHub Security Advisories**: Use the [Security Advisories](https://github.com/hasna/knowledge/security/advisories/new) feature to report privately.
-
-Include in your report:
-- Description of the vulnerability
-- Steps to reproduce
-- Potential impact
-- Any suggested fixes (optional)
-
-## Response Timeline
-
-- **Acknowledgment**: within 48 hours
-- **Initial assessment**: within 5 days
-- **Fix timeline**: depends on severity; critical issues are addressed immediately
-
-## Scope
-
-This project stores data in a local JSON file (`~/.open-knowledge/db.json` by default). Security considerations:
-
-- Store file permissions should be restricted to the owner
-- No network access or remote code execution
-- No authentication (local CLI tool)
-- Encryption of the store file is not currently implemented

package/npmignore

@@ -1,9 +0,0 @@
-tests/
-.github/
-.gitignore
-.git/
-.env*
-*.test.ts
-*.test.js
-tsconfig.json
-bun.lockb

package/tests/cli.test.ts

@@ -1,91 +0,0 @@
-/**
- * @hasna/knowledge
- * Copyright 2026 Hasna Inc.
- * Licensed under the Apache License, Version 2.0
- */
-import { describe, expect, test } from 'bun:test';
-import { mkdtempSync, readFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CLI = join(__dirname, '..', 'src', 'cli.ts');
-
-function runCli(args: string[]) {
-  return Bun.spawnSync(['bun', CLI, ...args], {
-    stdout: 'pipe',
-    stderr: 'pipe'
-  });
-}
-
-describe('open-knowledge cli', () => {
-  test('help and subcommand help work', () => {
-    const result = runCli(['--help']);
-    expect(result.exitCode).toBe(0);
-    const out = new TextDecoder().decode(result.stdout);
-    expect(out).toContain('open-knowledge');
-    expect(out).toContain('Commands:');
-
-    const sub = runCli(['help', 'list']);
-    expect(sub.exitCode).toBe(0);
-    const subOut = new TextDecoder().decode(sub.stdout);
-    expect(subOut).toContain('--sort created|title');
-  });
-
-  test('version flag works', () => {
-    const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')) as { version: string };
-    const result = runCli(['--version']);
-    expect(result.exitCode).toBe(0);
-    const out = new TextDecoder().decode(result.stdout);
-    expect(out.trim()).toBe(pkg.version);
-  });
-
-  test('unknown command includes suggestion', () => {
-    const result = runCli(['lits']);
-    expect(result.exitCode).toBe(1);
-    const err = new TextDecoder().decode(result.stderr);
-    expect(err).toContain("Did you mean 'list'");
-  });
-
-  test('add/list/get/delete flow with json and confirmation', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'ok-cli-'));
-    const store = join(dir, 'db.json');
-
-    const addA = runCli(['add', 'TitleB', 'BodyA', '--store', store, '--json']);
-    expect(addA.exitCode).toBe(0);
-    const addAOut = JSON.parse(new TextDecoder().decode(addA.stdout));
-
-    const addB = runCli(['add', 'TitleA', 'BodyB', '--store', store, '--json']);
-    expect(addB.exitCode).toBe(0);
-    const addBOut = JSON.parse(new TextDecoder().decode(addB.stdout));
-
-    const list = runCli(['ls', '--store', store, '--json', '-p', '1', '-l', '10', '--sort', 'title']);
-    expect(list.exitCode).toBe(0);
-    const listOut = JSON.parse(new TextDecoder().decode(list.stdout));
-    expect(listOut.total).toBe(2);
-    expect(listOut.total_pages).toBe(1);
-    expect(listOut.items[0].title).toBe('TitleA');
-
-    const get = runCli(['get', '--id', addAOut.item.id, '--store', store, '--json']);
-    expect(get.exitCode).toBe(0);
-    const getOut = JSON.parse(new TextDecoder().decode(get.stdout));
-    expect(getOut.item.content).toBe('BodyA');
-
-    const delNoYes = runCli(['rm', '--id', addAOut.item.id, '--store', store, '--json']);
-    expect(delNoYes.exitCode).toBe(1);
-    const delErr = new TextDecoder().decode(delNoYes.stderr);
-    expect(delErr).toContain('Refusing delete without --yes');
-
-    const del = runCli(['delete', '--id', addAOut.item.id, '--store', store, '--json', '--yes']);
-    expect(del.exitCode).toBe(0);
-    const delOut = JSON.parse(new TextDecoder().decode(del.stdout));
-    expect(delOut.ok).toBe(true);
-
-    const del2 = runCli(['delete', '--id', addBOut.item.id, '--store', store, '--json', '--yes']);
-    expect(del2.exitCode).toBe(0);
-
-    const db = JSON.parse(readFileSync(store, 'utf8'));
-    expect(db.items.length).toBe(0);
-  });
-});

package/tests/mcp-http.test.ts

@@ -1,97 +0,0 @@
-import { afterAll, beforeAll, describe, expect, test } from 'bun:test';
-import { mkdtempSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
-import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
-import { buildServer } from '../src/mcp.js';
-import {
-  DEFAULT_MCP_HTTP_PORT,
-  isHttpMode,
-  resolveMcpHttpPort,
-  startMcpHttpServer,
-} from '../src/mcp-http.js';
-
-const storePath = join(mkdtempSync(join(tmpdir(), 'knowledge-mcp-http-')), 'db.json');
-
-describe('knowledge MCP HTTP transport', () => {
-  test('defaults port to 8819', () => {
-    expect(DEFAULT_MCP_HTTP_PORT).toBe(8819);
-    expect(resolveMcpHttpPort(['node'], {})).toBe(8819);
-    expect(resolveMcpHttpPort(['node', '--port', '9001'], {})).toBe(9001);
-    expect(resolveMcpHttpPort(['node'], { MCP_HTTP_PORT: '9002' })).toBe(9002);
-  });
-
-  test('isHttpMode detects flag and env', () => {
-    expect(isHttpMode(['node'], {})).toBe(false);
-    expect(isHttpMode(['node', '--http'], {})).toBe(true);
-    expect(isHttpMode(['node'], { MCP_HTTP: '1' })).toBe(true);
-  });
-});
-
-describe('knowledge buildServer stdio registration', () => {
-  test('registers tools over in-memory transport', async () => {
-    const server = buildServer();
-    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
-    await server.connect(serverTransport);
-
-    const client = new Client({ name: 'test', version: '0.0.0' });
-    await client.connect(clientTransport);
-
-    const tools = await client.listTools();
-    expect(tools.tools.some((tool) => tool.name === 'ok_stats')).toBe(true);
-
-    await client.close();
-    await server.close();
-  });
-});
-
-describe('knowledge streamable HTTP server', () => {
-  let handle: Awaited<ReturnType<typeof startMcpHttpServer>>;
-
-  beforeAll(async () => {
-    handle = await startMcpHttpServer(buildServer, { port: 0 });
-  });
-
-  afterAll(async () => {
-    await handle.close();
-  });
-
-  test('GET /health returns ok', async () => {
-    const res = await fetch(`http://${handle.host}:${handle.port}/health`);
-    expect(res.status).toBe(200);
-    expect(await res.json()).toEqual({ status: 'ok', name: 'knowledge' });
-  });
-
-  test('initialize and call ok_stats over streamable HTTP', async () => {
-    const transport = new StreamableHTTPClientTransport(
-      new URL(`http://${handle.host}:${handle.port}/mcp`),
-    );
-    const client = new Client({ name: 'test', version: '0.0.0' });
-    await client.connect(transport);
-
-    const result = await client.callTool({ name: 'ok_stats', arguments: { store_path: storePath } });
-    expect(result.content).toBeDefined();
-    expect(Array.isArray(result.content)).toBe(true);
-
-    await client.close();
-  });
-
-  test('serves three concurrent clients from one process', async () => {
-    const clients = await Promise.all(
-      Array.from({ length: 3 }, async () => {
-        const transport = new StreamableHTTPClientTransport(
-          new URL(`http://${handle.host}:${handle.port}/mcp`),
-        );
-        const client = new Client({ name: 'test', version: '0.0.0' });
-        await client.connect(transport);
-        const tools = await client.listTools();
-        return { client, count: tools.tools.length };
-      }),
-    );
-
-    expect(clients.every((entry) => entry.count > 0)).toBe(true);
-    await Promise.all(clients.map((entry) => entry.client.close()));
-  });
-});

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": false,
-    "skipLibCheck": true,
-    "allowImportingExtensions": true,
-    "noEmit": true
-  },
-  "include": ["src/**/*", "tests/**/*"],
-  "exclude": ["node_modules", "dist", "bin"]
-}