@hasna/contacts 0.6.8 → 0.6.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -69
- package/dist/cli/commands/advanced.d.ts +3 -0
- package/dist/cli/commands/advanced.d.ts.map +1 -0
- package/dist/cli/commands/core.d.ts +3 -0
- package/dist/cli/commands/core.d.ts.map +1 -0
- package/dist/cli/commands/crm.d.ts +3 -0
- package/dist/cli/commands/crm.d.ts.map +1 -0
- package/dist/cli/index.js +8131 -6891
- package/dist/cli/utils.d.ts +10 -0
- package/dist/cli/utils.d.ts.map +1 -0
- package/dist/db/activity.test.d.ts +2 -0
- package/dist/db/activity.test.d.ts.map +1 -0
- package/dist/db/applications.test.d.ts +2 -0
- package/dist/db/applications.test.d.ts.map +1 -0
- package/dist/db/contact-tasks.test.d.ts +2 -0
- package/dist/db/contact-tasks.test.d.ts.map +1 -0
- package/dist/db/coordination.test.d.ts +2 -0
- package/dist/db/coordination.test.d.ts.map +1 -0
- package/dist/db/deals.test.d.ts +2 -0
- package/dist/db/deals.test.d.ts.map +1 -0
- package/dist/db/documents.test.d.ts +2 -0
- package/dist/db/documents.test.d.ts.map +1 -0
- package/dist/db/events.test.d.ts +2 -0
- package/dist/db/events.test.d.ts.map +1 -0
- package/dist/db/field-history.test.d.ts +2 -0
- package/dist/db/field-history.test.d.ts.map +1 -0
- package/dist/db/freshness.test.d.ts +2 -0
- package/dist/db/freshness.test.d.ts.map +1 -0
- package/dist/db/graph.test.d.ts +2 -0
- package/dist/db/graph.test.d.ts.map +1 -0
- package/dist/db/groups.test.d.ts +2 -0
- package/dist/db/groups.test.d.ts.map +1 -0
- package/dist/db/health.test.d.ts +2 -0
- package/dist/db/health.test.d.ts.map +1 -0
- package/dist/db/identity.test.d.ts +2 -0
- package/dist/db/identity.test.d.ts.map +1 -0
- package/dist/db/job-history.test.d.ts +2 -0
- package/dist/db/job-history.test.d.ts.map +1 -0
- package/dist/db/learnings.test.d.ts +2 -0
- package/dist/db/learnings.test.d.ts.map +1 -0
- package/dist/db/org-chart.test.d.ts +2 -0
- package/dist/db/org-chart.test.d.ts.map +1 -0
- package/dist/db/org-members.test.d.ts +2 -0
- package/dist/db/org-members.test.d.ts.map +1 -0
- package/dist/db/signals.test.d.ts +2 -0
- package/dist/db/signals.test.d.ts.map +1 -0
- package/dist/db/vendor-comms.test.d.ts +2 -0
- package/dist/db/vendor-comms.test.d.ts.map +1 -0
- package/dist/index.js +3515 -2960
- package/dist/lib/audit.test.d.ts +2 -0
- package/dist/lib/audit.test.d.ts.map +1 -0
- package/dist/lib/brief.test.d.ts +2 -0
- package/dist/lib/brief.test.d.ts.map +1 -0
- package/dist/lib/config.test.d.ts +2 -0
- package/dist/lib/config.test.d.ts.map +1 -0
- package/dist/lib/dedup.test.d.ts +2 -0
- package/dist/lib/dedup.test.d.ts.map +1 -0
- package/dist/lib/export.test.d.ts +2 -0
- package/dist/lib/export.test.d.ts.map +1 -0
- package/dist/lib/signature-parser.test.d.ts +2 -0
- package/dist/lib/signature-parser.test.d.ts.map +1 -0
- package/dist/lib/stats.test.d.ts +2 -0
- package/dist/lib/stats.test.d.ts.map +1 -0
- package/dist/lib/timeline.test.d.ts +2 -0
- package/dist/lib/timeline.test.d.ts.map +1 -0
- package/dist/lib/upcoming.test.d.ts +2 -0
- package/dist/lib/upcoming.test.d.ts.map +1 -0
- package/dist/mcp/handlers/advanced.d.ts +9 -0
- package/dist/mcp/handlers/advanced.d.ts.map +1 -0
- package/dist/mcp/handlers/core.d.ts +6 -0
- package/dist/mcp/handlers/core.d.ts.map +1 -0
- package/dist/mcp/handlers/crm.d.ts +9 -0
- package/dist/mcp/handlers/crm.d.ts.map +1 -0
- package/dist/mcp/handlers/index.d.ts +4 -0
- package/dist/mcp/handlers/index.d.ts.map +1 -0
- package/dist/mcp/handlers/types.d.ts +10 -0
- package/dist/mcp/handlers/types.d.ts.map +1 -0
- package/dist/mcp/index.js +11729 -10562
- package/dist/mcp/tools.d.ts +3547 -0
- package/dist/mcp/tools.d.ts.map +1 -0
- package/dist/server/index.js +3783 -3148
- package/package.json +3 -3
- package/dashboard/dist/assets/index-0l6aQb1t.css +0 -1
- package/dashboard/dist/assets/index-opnZdkVD.js +0 -229
- package/dashboard/dist/index.html +0 -13
package/README.md
CHANGED
|
@@ -1,93 +1,48 @@
|
|
|
1
1
|
# @hasna/contacts
|
|
2
2
|
|
|
3
|
-
Contact management for AI coding agents — CLI + MCP
|
|
3
|
+
Contact management for AI coding agents — CLI + MCP + Web
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
## Features
|
|
8
|
-
|
|
9
|
-
- **MCP server** — 24 tools for AI agents (Claude, Codex, Gemini)
|
|
10
|
-
- **CLI** — beautiful terminal interface
|
|
11
|
-
- **Web dashboard** — React/Vite UI
|
|
12
|
-
- **Rich data model** — contacts, companies, tags, relationships, emails, phones, addresses, social profiles
|
|
13
|
-
- **Import/Export** — CSV, vCard (.vcf), JSON
|
|
14
|
-
- **Full-text search** — FTS5-powered search
|
|
15
|
-
- **SQLite** — zero-config, file-based storage at `~/.contacts/contacts.db`
|
|
5
|
+
[](https://www.npmjs.com/package/@hasna/contacts)
|
|
6
|
+
[](LICENSE)
|
|
16
7
|
|
|
17
8
|
## Install
|
|
18
9
|
|
|
19
10
|
```bash
|
|
20
|
-
bun install -g @hasna/contacts
|
|
21
|
-
# or
|
|
22
11
|
npm install -g @hasna/contacts
|
|
23
12
|
```
|
|
24
13
|
|
|
25
14
|
## CLI Usage
|
|
26
15
|
|
|
27
16
|
```bash
|
|
28
|
-
contacts
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
contacts
|
|
35
|
-
contacts import contacts.csv # Import from CSV/vCard/JSON
|
|
36
|
-
contacts export --format vcf # Export as vCard
|
|
37
|
-
contacts companies # List companies
|
|
38
|
-
contacts tags # Manage tags
|
|
39
|
-
contacts serve # Start web dashboard
|
|
40
|
-
contacts mcp # Show MCP setup
|
|
17
|
+
contacts --help
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## MCP Server
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
contacts-mcp
|
|
41
24
|
```
|
|
42
25
|
|
|
43
|
-
##
|
|
26
|
+
## REST API
|
|
44
27
|
|
|
45
|
-
Add to your Claude Code config:
|
|
46
28
|
```bash
|
|
47
|
-
|
|
29
|
+
contacts-serve
|
|
48
30
|
```
|
|
49
31
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
}
|
|
59
|
-
}
|
|
32
|
+
## Cloud Sync
|
|
33
|
+
|
|
34
|
+
This package supports cloud sync via `@hasna/cloud`:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
cloud setup
|
|
38
|
+
cloud sync push --service contacts
|
|
39
|
+
cloud sync pull --service contacts
|
|
60
40
|
```
|
|
61
41
|
|
|
62
|
-
##
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|------|-------------|
|
|
66
|
-
| `create_contact` | Create a new contact |
|
|
67
|
-
| `get_contact` | Get contact by ID |
|
|
68
|
-
| `update_contact` | Update contact fields |
|
|
69
|
-
| `delete_contact` | Delete a contact |
|
|
70
|
-
| `list_contacts` | List contacts with filters |
|
|
71
|
-
| `search_contacts` | Full-text search |
|
|
72
|
-
| `create_company` | Create a company |
|
|
73
|
-
| `get_company` | Get company by ID |
|
|
74
|
-
| `list_companies` | List companies |
|
|
75
|
-
| `search_companies` | Search companies |
|
|
76
|
-
| `create_tag` | Create a tag |
|
|
77
|
-
| `list_tags` | List all tags |
|
|
78
|
-
| `add_tag_to_contact` | Tag a contact |
|
|
79
|
-
| `add_relationship` | Link contacts |
|
|
80
|
-
| `merge_contacts` | Merge duplicate contacts |
|
|
81
|
-
| `import_contacts` | Import CSV/vCard/JSON |
|
|
82
|
-
| `export_contacts` | Export contacts |
|
|
83
|
-
| `get_stats` | Get database stats |
|
|
84
|
-
|
|
85
|
-
## Environment
|
|
86
|
-
|
|
87
|
-
| Variable | Default | Description |
|
|
88
|
-
|----------|---------|-------------|
|
|
89
|
-
| `CONTACTS_DB_PATH` | `~/.contacts/contacts.db` | SQLite database path |
|
|
42
|
+
## Data Directory
|
|
43
|
+
|
|
44
|
+
Data is stored in `~/.hasna/contacts/`.
|
|
90
45
|
|
|
91
46
|
## License
|
|
92
47
|
|
|
93
|
-
Apache-2.0
|
|
48
|
+
Apache-2.0 -- see [LICENSE](LICENSE)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/advanced.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAg5B/D"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/core.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAo1B3D"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"crm.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/crm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgDzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAu6B1D"}
|