@hasna/contacts 0.6.8 → 0.6.9

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.
Files changed (85) hide show
  1. package/README.md +24 -69
  2. package/dist/cli/commands/advanced.d.ts +3 -0
  3. package/dist/cli/commands/advanced.d.ts.map +1 -0
  4. package/dist/cli/commands/core.d.ts +3 -0
  5. package/dist/cli/commands/core.d.ts.map +1 -0
  6. package/dist/cli/commands/crm.d.ts +3 -0
  7. package/dist/cli/commands/crm.d.ts.map +1 -0
  8. package/dist/cli/index.js +8128 -6891
  9. package/dist/cli/utils.d.ts +10 -0
  10. package/dist/cli/utils.d.ts.map +1 -0
  11. package/dist/db/activity.test.d.ts +2 -0
  12. package/dist/db/activity.test.d.ts.map +1 -0
  13. package/dist/db/applications.test.d.ts +2 -0
  14. package/dist/db/applications.test.d.ts.map +1 -0
  15. package/dist/db/contact-tasks.test.d.ts +2 -0
  16. package/dist/db/contact-tasks.test.d.ts.map +1 -0
  17. package/dist/db/coordination.test.d.ts +2 -0
  18. package/dist/db/coordination.test.d.ts.map +1 -0
  19. package/dist/db/deals.test.d.ts +2 -0
  20. package/dist/db/deals.test.d.ts.map +1 -0
  21. package/dist/db/documents.test.d.ts +2 -0
  22. package/dist/db/documents.test.d.ts.map +1 -0
  23. package/dist/db/events.test.d.ts +2 -0
  24. package/dist/db/events.test.d.ts.map +1 -0
  25. package/dist/db/field-history.test.d.ts +2 -0
  26. package/dist/db/field-history.test.d.ts.map +1 -0
  27. package/dist/db/freshness.test.d.ts +2 -0
  28. package/dist/db/freshness.test.d.ts.map +1 -0
  29. package/dist/db/graph.test.d.ts +2 -0
  30. package/dist/db/graph.test.d.ts.map +1 -0
  31. package/dist/db/groups.test.d.ts +2 -0
  32. package/dist/db/groups.test.d.ts.map +1 -0
  33. package/dist/db/health.test.d.ts +2 -0
  34. package/dist/db/health.test.d.ts.map +1 -0
  35. package/dist/db/identity.test.d.ts +2 -0
  36. package/dist/db/identity.test.d.ts.map +1 -0
  37. package/dist/db/job-history.test.d.ts +2 -0
  38. package/dist/db/job-history.test.d.ts.map +1 -0
  39. package/dist/db/learnings.test.d.ts +2 -0
  40. package/dist/db/learnings.test.d.ts.map +1 -0
  41. package/dist/db/org-chart.test.d.ts +2 -0
  42. package/dist/db/org-chart.test.d.ts.map +1 -0
  43. package/dist/db/org-members.test.d.ts +2 -0
  44. package/dist/db/org-members.test.d.ts.map +1 -0
  45. package/dist/db/signals.test.d.ts +2 -0
  46. package/dist/db/signals.test.d.ts.map +1 -0
  47. package/dist/db/vendor-comms.test.d.ts +2 -0
  48. package/dist/db/vendor-comms.test.d.ts.map +1 -0
  49. package/dist/index.js +3515 -2960
  50. package/dist/lib/audit.test.d.ts +2 -0
  51. package/dist/lib/audit.test.d.ts.map +1 -0
  52. package/dist/lib/brief.test.d.ts +2 -0
  53. package/dist/lib/brief.test.d.ts.map +1 -0
  54. package/dist/lib/config.test.d.ts +2 -0
  55. package/dist/lib/config.test.d.ts.map +1 -0
  56. package/dist/lib/dedup.test.d.ts +2 -0
  57. package/dist/lib/dedup.test.d.ts.map +1 -0
  58. package/dist/lib/export.test.d.ts +2 -0
  59. package/dist/lib/export.test.d.ts.map +1 -0
  60. package/dist/lib/signature-parser.test.d.ts +2 -0
  61. package/dist/lib/signature-parser.test.d.ts.map +1 -0
  62. package/dist/lib/stats.test.d.ts +2 -0
  63. package/dist/lib/stats.test.d.ts.map +1 -0
  64. package/dist/lib/timeline.test.d.ts +2 -0
  65. package/dist/lib/timeline.test.d.ts.map +1 -0
  66. package/dist/lib/upcoming.test.d.ts +2 -0
  67. package/dist/lib/upcoming.test.d.ts.map +1 -0
  68. package/dist/mcp/handlers/advanced.d.ts +9 -0
  69. package/dist/mcp/handlers/advanced.d.ts.map +1 -0
  70. package/dist/mcp/handlers/core.d.ts +6 -0
  71. package/dist/mcp/handlers/core.d.ts.map +1 -0
  72. package/dist/mcp/handlers/crm.d.ts +9 -0
  73. package/dist/mcp/handlers/crm.d.ts.map +1 -0
  74. package/dist/mcp/handlers/index.d.ts +4 -0
  75. package/dist/mcp/handlers/index.d.ts.map +1 -0
  76. package/dist/mcp/handlers/types.d.ts +10 -0
  77. package/dist/mcp/handlers/types.d.ts.map +1 -0
  78. package/dist/mcp/index.js +11729 -10562
  79. package/dist/mcp/tools.d.ts +3547 -0
  80. package/dist/mcp/tools.d.ts.map +1 -0
  81. package/dist/server/index.js +3783 -3148
  82. package/package.json +3 -3
  83. package/dashboard/dist/assets/index-0l6aQb1t.css +0 -1
  84. package/dashboard/dist/assets/index-opnZdkVD.js +0 -229
  85. 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 server + Web dashboard
3
+ Contact management for AI coding agents — CLI + MCP + Web
4
4
 
5
- A modern rolodex for AI agents and humans. Store contacts, companies, tags, relationships, social profiles, and more.
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
+ [![npm](https://img.shields.io/npm/v/@hasna/contacts)](https://www.npmjs.com/package/@hasna/contacts)
6
+ [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](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 add # Add a contact interactively
29
- contacts list # List all contacts
30
- contacts list --tag vip # Filter by tag
31
- contacts show <id> # Show contact details
32
- contacts search "John" # Search contacts
33
- contacts edit <id> # Edit a contact
34
- contacts delete <id> # Delete a contact
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
- ## MCP Setup
26
+ ## REST API
44
27
 
45
- Add to your Claude Code config:
46
28
  ```bash
47
- claude mcp add --transport stdio --scope user contacts -- contacts-mcp
29
+ contacts-serve
48
30
  ```
49
31
 
50
- Or add to `~/.claude.json`:
51
- ```json
52
- {
53
- "mcpServers": {
54
- "contacts": {
55
- "command": "contacts-mcp",
56
- "args": []
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
- ## MCP Tools
63
-
64
- | Tool | Description |
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 © Andrei Hasna
48
+ Apache-2.0 -- see [LICENSE](LICENSE)
@@ -0,0 +1,3 @@
1
+ import type { Command } from "commander";
2
+ export declare function registerAdvancedCommands(program: Command): void;
3
+ //# sourceMappingURL=advanced.d.ts.map
@@ -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,3 @@
1
+ import type { Command } from "commander";
2
+ export declare function registerCoreCommands(program: Command): void;
3
+ //# sourceMappingURL=core.d.ts.map
@@ -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,3 @@
1
+ import type { Command } from "commander";
2
+ export declare function registerCrmCommands(program: Command): void;
3
+ //# sourceMappingURL=crm.d.ts.map
@@ -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"}