# alignmink-context-cursor

> Shared company context for a small team — the git-repo equivalent of organizational intent.

OSS utility that stores **Spine** (strategic + domain OKR-style intent), **Documents** (SOPs, AOPs, playbooks, brand guidelines), and **Decision traces** ([alignmink-dtp](https://www.npmjs.com/package/alignmink-dtp) / DTP v0.1) in a local SQLite or Supabase Postgres store. Agents and humans query it through MCP with citable records.

No hard deletes. Records are versioned, superseded, or deprecated.

## Status

**Chunks 0–11 complete on this branch** — shared context store, compile engine, CLI, MCP (stdio + HTTP/OAuth), web review UI, DTP import, Hermes docs, Slack slash connector, Google Drive ingest, Docker deploy. See [docs/chunks](docs/chunks).

| Chunk | Status | Outcome |
|------|--------|---------|
| 0 | done | Repo, CI, schema package smoke tests |
| 1 | done | DB + immutable lifecycle |
| 2 | done | Compile engine (evidence-bound) |
| 3 | done | CLI + local MCP serve + tokens |
| 4 | done | MCP core + Claude connectors |
| 5 | done | Remote HTTP MCP + OAuth PKCE (ChatGPT/Claude connectors) |
| 6 | done | Non-technical web UI |
| 7 | done | DTP import |
| 8 | done | Hermes connector |
| 9 | done | Slack `/context` connector |
| 10 | done | Google Workspace ingest |
| 11 | done | Docker + Compose HTTP MCP on :8787 |

## Quickstart

```bash
# Node 20+; enable pnpm once
corepack enable
pnpm install
pnpm --filter @alignmink/context-schema build
pnpm --filter @alignmink/context-db build
pnpm --filter @alignmink/context-compile build
pnpm --filter @alignmink/context-auth build
pnpm --filter @alignmink/context-mcp-server build
pnpm --filter @alignmink/context-cli build
```

### CLI (Chunk 3)

```bash
# Initialize a local SQLite workspace (~/.alignmink-context)
pnpm --filter @alignmink/context-cli exec alignmink-context init --name "Acme" --slug acme

# Compile + commit an evidenced spine proposal, mint an MCP token, query with citations
pnpm --filter @alignmink/context-cli exec alignmink-context --help

# Stdio MCP server (bin: alignmink-context-mcp)
pnpm --filter @alignmink/context-mcp-server exec alignmink-context-mcp
```

## Knowledge model

1. **Strategic Spine / Domain Spines** — mission, stage, bets, ranked priorities, explicit not-doing, metrics
2. **Documents** — versioned markdown (SOPs, plans, playbooks, research)
3. **Decision traces** — DTP v0.1 JSON (what/why/alternatives/revisit triggers)

## Connectors (planned)

Claude (all apps), ChatGPT (Chat + Codex), Hermes, Slack, Google Workspace.

## License

Apache-2.0 — see [LICENSE](LICENSE).