@ozzylabs/suasor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ozzy-labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,83 @@
+# Suasor
+
+**集め、覚え、助言する - 決めるのはあなた。**
+
+Suasor はローカルファーストの AI 秘書です。チャット・メール・カレンダー・ドキュメント・コード・Web に散らばった業務情報をプライベートメモリに集め、あなたと AI エージェントが MCP 経由で検索・要約できるようにします。そして、助言し、返信・タスク・決定を提案します。送信も書き込みも、あなたの承認なく行いません。
+
+[English →](README.md)
+
+## できること
+
+- **集める** — あちこちのツールに散らばった業務情報を、手元のプライベートなストアに 1 か所へ集めます。read 専用で、元のソースに書き戻すことはありません。
+- **覚える** — それを検索・参照できる記憶として、あなたのマシン上に保持します。
+- **助言する** — MCP 経由で提示・要約し、返信・タスク・決定を提案します。あなたと AI エージェントが引き出し、適用するかはあなたが決めます。あなたの承認なく、送信も書き込みもしません。
+
+## ステータス
+
+開発初期。Suasor は仕様駆動で構築中です。
+
+## インストール
+
+4 つのチャネルで配布します（リリースは手動 — [docs/guide/install.md](docs/guide/install.md) 参照）:
+
+- **npm** — `bunx @ozzylabs/suasor mcp serve`（または `bun add -g @ozzylabs/suasor`）。canonical・OIDC publish（provenance 付き）。
+- **単一バイナリ** — OS/arch 別に [Releases](https://github.com/ozzy-labs/suasor/releases) からダウンロード。core + 少数 native のみで、重い connector SDK は external（全 connector は npm/Docker を利用）。
+- **Docker（Ollama 同梱）** — `docker run ghcr.io/ozzy-labs/suasor`。egress なしのローカル embedding。
+- **MCP registry** — [`server.json`](server.json) で discovery 可能。
+
+> 初回リリース公開までは、下記クイックスタートでソースから実行してください。
+
+## クイックスタート（暫定）
+
+> 開発初期ですが、下記の CLI コマンドはすべて実装済みです（取り込み・検索・MCP server・skill すべて動作）。未提供は `brief` / `graph.related` の MCP tool のみ（[docs/design/mcp-surface.md](docs/design/mcp-surface.md) 参照）。[Bun](https://bun.sh) 1.1+ が必要です。
+
+```bash
+bun install            # 依存インストール
+bun run src/index.ts --version
+
+# 初回セットアップ: ~/.config/suasor/config.toml とローカル SQLite ストアを作成。
+bun run src/index.ts init
+
+# コネクタから read 専用で取り込み（github / slack / ms-graph / google / box / web）。
+bun run src/index.ts github sync
+
+# source 本文の全文検索（FTS5。--json / --limit 利用可）。
+bun run src/index.ts search "<query>"
+
+# 同梱のアシスタント skill をエージェントホストへ展開。
+bun run src/index.ts skills install        # .claude/skills/ + .agents/skills/
+bun run src/index.ts skills list           # installed / missing / modified
+
+# メンテナンス。
+bun run src/index.ts db migrate            # projection schema 適用（idempotent）
+bun run src/index.ts projections rebuild   # event log を replay して projection 再構築
+```
+
+設定は `~/.config/suasor/`（`SUASOR_CONFIG_DIR` で上書き）に置かれます。`<connector> sync` は github / slack / ms-graph / google / box / web から read 専用で取り込みます（各コネクタの設定は [docs/guide/connectors.md](docs/guide/connectors.md)）。コマンド・フラグの一覧は [docs/design/cli.md](docs/design/cli.md)、アシスタント skill は [docs/skills/README.md](docs/skills/README.md) を参照してください。
+
+## エージェントホストと接続する（MCP）
+
+Suasor は記憶を AI エージェントへ [Model Context Protocol](https://modelcontextprotocol.io)（stdio transport）で公開します。この server がエージェント境界です。**read** tool — `search` / `recall.search` / `source.list`・`source.get` / `task.list`・`decision.list`・`inbox.list` — はいずれも副作用なしで read-only annotation 付き（host が auto-approve 可）。**write** tool — `connector.sync` / `propose.generate` / `propose.apply` / `task.create` — も現在提供していますが、HITL（人の承認）の後ろに置かれます（ADR-0004）。承認なく適用・送信はしません。
+
+```bash
+bun run src/index.ts mcp serve   # MCP server を stdio で起動
+```
+
+MCP host（Claude Code / Claude Desktop / Codex CLI 等）に登録します。Claude Desktop の場合は `claude_desktop_config.json` に以下を追加します:
+
+```jsonc
+{
+  "mcpServers": {
+    "suasor": {
+      "command": "suasor",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+意味検索（`recall.search`）は embedding backend を有効にするまで `embedding_disabled` シグナルを返すため、host は FTS の `search` へ graceful にフォールバックできます（ADR-0005）。tool スキーマは [docs/design/mcp-surface.md](docs/design/mcp-surface.md) を参照してください。
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,83 @@
+# Suasor
+
+**Gathers, remembers, advises - you decide.**
+
+Suasor is a local-first AI secretary. It gathers your scattered work context - chat, email, calendar, documents, code, the web - into private memory on your own machine, so you and your AI agents can search and summarize it over MCP. It advises you, and proposes replies, tasks, and decisions. Nothing is sent or saved without your approval.
+
+[日本語 / Japanese →](README.ja.md)
+
+## What it does
+
+- **Gathers** — pulls your scattered work context from across your tools into one local, private store. Read-only: it never writes back to your sources.
+- **Remembers** — keeps it as searchable, queryable memory on your own machine.
+- **Advises** — surfaces, summarizes, and proposes replies, tasks, and decisions over MCP. You and your AI agents query it; you approve everything. Nothing is sent or saved without your say.
+
+## Status
+
+Early development. Suasor is being built spec-first.
+
+## Install
+
+Distributed via four channels (released manually — see [docs/guide/install.md](docs/guide/install.md)):
+
+- **npm** — `bunx @ozzylabs/suasor mcp serve` (or `bun add -g @ozzylabs/suasor`). Canonical; OIDC-published with provenance.
+- **Standalone binary** — download per OS/arch from [Releases](https://github.com/ozzy-labs/suasor/releases). Core + a few native bits; the heavier connector SDKs are external (use npm/Docker for the full connector set).
+- **Docker (batteries-included + Ollama)** — `docker run ghcr.io/ozzy-labs/suasor`. Local embedding with no external egress.
+- **MCP registry** — discoverable via [`server.json`](server.json).
+
+> Until the first release is published, run from source with the Quickstart below.
+
+## Quickstart (provisional)
+
+> Early development, but every CLI command below is implemented (ingest, retrieval, MCP server, and skills all work). The only not-yet-shipped pieces are the `brief` / `graph.related` MCP tools — see [docs/design/mcp-surface.md](docs/design/mcp-surface.md). Requires [Bun](https://bun.sh) 1.1+.
+
+```bash
+bun install            # install dependencies
+bun run src/index.ts --version
+
+# First-run setup: writes ~/.config/suasor/config.toml and the local SQLite store.
+bun run src/index.ts init
+
+# Ingest read-only from a connector (github / slack / ms-graph / google / box / web).
+bun run src/index.ts github sync
+
+# Full-text search over ingested sources (FTS5; --json / --limit available).
+bun run src/index.ts search "<query>"
+
+# Install the bundled assistant skills into your agent host(s).
+bun run src/index.ts skills install        # .claude/skills/ + .agents/skills/
+bun run src/index.ts skills list           # installed / missing / modified
+
+# Maintenance.
+bun run src/index.ts db migrate            # apply the projection schema (idempotent)
+bun run src/index.ts projections rebuild   # replay the event log into projections
+```
+
+Config lives in `~/.config/suasor/` (override with `SUASOR_CONFIG_DIR`). `<connector> sync` ingests read-only from github / slack / ms-graph / google / box / web — see [docs/guide/connectors.md](docs/guide/connectors.md) for per-connector setup. See [docs/design/cli.md](docs/design/cli.md) for the full command/flag reference and [docs/skills/README.md](docs/skills/README.md) for the assistant skills.
+
+## Connect an agent host (MCP)
+
+Suasor exposes its memory to AI agents over the [Model Context Protocol](https://modelcontextprotocol.io) (stdio transport). The server is the agent boundary. **Read** tools — `search`, `recall.search`, `source.list` / `source.get`, and `task.list` / `decision.list` / `inbox.list` — are side-effect-free and annotated read-only so hosts may auto-approve them. **Write** tools — `connector.sync`, `propose.generate`, `propose.apply`, `task.create` — ship today but stay behind human-in-the-loop approval (ADR-0004); nothing is applied or sent without your say.
+
+```bash
+bun run src/index.ts mcp serve   # start the MCP server over stdio
+```
+
+Register it with an MCP host (Claude Code, Claude Desktop, Codex CLI, …). For Claude Desktop, add to `claude_desktop_config.json`:
+
+```jsonc
+{
+  "mcpServers": {
+    "suasor": {
+      "command": "suasor",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+Semantic search (`recall.search`) returns an `embedding_disabled` signal until you enable an embedding backend, so hosts gracefully fall back to FTS `search` (ADR-0005). See [docs/design/mcp-surface.md](docs/design/mcp-surface.md) for the tool schemas.
+
+## License
+
+MIT