Skip to content

Commit 3ee3a4b

Browse files
trentbrewtrentbrew
committed
npm ppublish
1 parent 3f18bcf commit 3ee3a4b

24 files changed

Lines changed: 4388 additions & 7 deletions

‎.code-hq/.gitignore‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
.meta/cache/
2+
.meta/indexes/

‎.code-hq/.meta/config.json‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"version": "1.0.0",
3+
"project": {
4+
"name": "",
5+
"repository": ""
6+
},
7+
"defaults": {
8+
"taskStatus": "todo",
9+
"taskPriority": "medium",
10+
"assignee": null
11+
},
12+
"views": {
13+
"default": "datatable",
14+
"taskView": "kanban"
15+
},
16+
"integrations": {},
17+
"workflows": {
18+
"autorun": []
19+
}
20+
}

‎.code-hq/entities/milestones.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Milestones
2+
3+
_No milestones yet._

‎.code-hq/entities/notes.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Notes
2+
3+
_No notes yet. Create one with `code-hq create note "Title"`_

‎.code-hq/entities/people.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# People
2+
3+
_No people yet._

‎.code-hq/entities/tasks.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Tasks
2+
3+
_No tasks yet. Create one with `code-hq create task "Title"`_

‎.code-hq/graph.jsonld‎

Lines changed: 168 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,168 @@
1+
{
2+
"@context": "https://schema.org",
3+
"@graph": [
4+
{
5+
"@id": "task:1761294050726",
6+
"@type": "Task",
7+
"title": "Implement OAuth 2.0 authentication",
8+
"status": "in-progress",
9+
"priority": "high",
10+
"tags": [
11+
"auth",
12+
"security",
13+
"backend"
14+
],
15+
"createdAt": "2025-10-24T08:20:50.726Z",
16+
"updatedAt": "2025-10-24T08:20:50.726Z"
17+
},
18+
{
19+
"@id": "task:1761294052657",
20+
"@type": "Task",
21+
"title": "Add two-factor authentication (2FA)",
22+
"status": "todo",
23+
"priority": "medium",
24+
"tags": [
25+
"auth",
26+
"security",
27+
"feature"
28+
],
29+
"createdAt": "2025-10-24T08:20:52.657Z",
30+
"updatedAt": "2025-10-24T08:20:52.657Z"
31+
},
32+
{
33+
"@id": "task:1761294054593",
34+
"@type": "Task",
35+
"title": "Fix database connection timeout",
36+
"status": "blocked",
37+
"priority": "critical",
38+
"tags": [
39+
"bug",
40+
"database",
41+
"hotfix"
42+
],
43+
"createdAt": "2025-10-24T08:20:54.593Z",
44+
"updatedAt": "2025-10-24T08:20:54.593Z"
45+
},
46+
{
47+
"@id": "task:1761294056707",
48+
"@type": "Task",
49+
"title": "Refactor API error handling",
50+
"status": "review",
51+
"priority": "medium",
52+
"tags": [
53+
"refactor",
54+
"api",
55+
"backend"
56+
],
57+
"createdAt": "2025-10-24T08:20:56.707Z",
58+
"updatedAt": "2025-10-24T08:20:56.707Z"
59+
},
60+
{
61+
"@id": "task:1761294059271",
62+
"@type": "Task",
63+
"title": "Update user onboarding flow",
64+
"status": "todo",
65+
"priority": "low",
66+
"tags": [
67+
"ux",
68+
"frontend",
69+
"feature"
70+
],
71+
"createdAt": "2025-10-24T08:20:59.271Z",
72+
"updatedAt": "2025-10-24T08:20:59.271Z"
73+
},
74+
{
75+
"@id": "task:1761294062087",
76+
"@type": "Task",
77+
"title": "Write API documentation",
78+
"status": "done",
79+
"priority": "medium",
80+
"tags": [
81+
"docs",
82+
"api"
83+
],
84+
"createdAt": "2025-10-24T08:21:02.087Z",
85+
"updatedAt": "2025-10-24T08:21:02.087Z"
86+
},
87+
{
88+
"@id": "task:1761294064900",
89+
"@type": "Task",
90+
"title": "Setup CI/CD pipeline",
91+
"status": "todo",
92+
"priority": "high",
93+
"tags": [
94+
"devops",
95+
"infrastructure"
96+
],
97+
"createdAt": "2025-10-24T08:21:04.900Z",
98+
"updatedAt": "2025-10-24T08:21:04.900Z"
99+
},
100+
{
101+
"@id": "note:1761294067403",
102+
"@type": "Note",
103+
"title": "Architecture Decision: Use PostgreSQL",
104+
"content": "We chose PostgreSQL over MongoDB because we need ACID transactions, complex joins, and strong consistency guarantees. PostgreSQL's JSON support gives us flexibility when needed without sacrificing relational integrity.",
105+
"type": "decision",
106+
"tags": [
107+
"architecture",
108+
"database",
109+
"decision"
110+
],
111+
"createdAt": "2025-10-24T08:21:07.403Z",
112+
"updatedAt": "2025-10-24T08:21:07.403Z"
113+
},
114+
{
115+
"@id": "note:1761294069243",
116+
"@type": "Note",
117+
"title": "OAuth Provider Research",
118+
"content": "Compared Auth0, Okta, and AWS Cognito. Auth0 offers best developer experience and pricing for our scale. Recommended for MVP with option to migrate to self-hosted later if needed.",
119+
"type": "research",
120+
"tags": [
121+
"research",
122+
"auth",
123+
"oauth"
124+
],
125+
"createdAt": "2025-10-24T08:21:09.243Z",
126+
"updatedAt": "2025-10-24T08:21:09.243Z"
127+
},
128+
{
129+
"@id": "note:1761294069349",
130+
"@type": "Note",
131+
"title": "Sprint Planning Meeting - Jan 2025",
132+
"content": "Reviewed Q1 roadmap. Priorities: (1) Complete auth system, (2) Improve performance, (3) Add 2FA. Team velocity: 25 story points/sprint. Next sprint starts Jan 27.",
133+
"type": "meeting",
134+
"tags": [
135+
"meeting",
136+
"sprint-planning"
137+
],
138+
"createdAt": "2025-10-24T08:21:09.349Z",
139+
"updatedAt": "2025-10-24T08:21:09.349Z"
140+
},
141+
{
142+
"@id": "note:1761294069492",
143+
"@type": "Note",
144+
"title": "Blocker: Database credentials needed",
145+
"content": "Task blocked waiting for production database credentials. Requested from ops@company.com on Jan 20. Expected delivery: Jan 25. Impacts OAuth implementation timeline.",
146+
"type": "general",
147+
"tags": [
148+
"blocker",
149+
"devops"
150+
],
151+
"createdAt": "2025-10-24T08:21:09.492Z",
152+
"updatedAt": "2025-10-24T08:21:09.492Z"
153+
},
154+
{
155+
"@id": "note:1761294069717",
156+
"@type": "Note",
157+
"title": "Idea: Real-time collaboration features",
158+
"content": "What if multiple developers could work on the knowledge graph simultaneously? Could use WebSockets + CRDTs for conflict-free updates. Would need backend service. Worth exploring for v2.0.",
159+
"type": "idea",
160+
"tags": [
161+
"feature-idea",
162+
"collaboration"
163+
],
164+
"createdAt": "2025-10-24T08:21:09.717Z",
165+
"updatedAt": "2025-10-24T08:21:09.717Z"
166+
}
167+
]
168+
}

‎.code-hq/prompts/_index.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# code-hq Agent Guide
2+
3+
**For AI Agents**: This project uses **code-hq** for semantic project management.
4+
5+
## What is code-hq?
6+
7+
code-hq is a local knowledge graph that tracks:
8+
- **Tasks** - Work items with status, priority, assignees, dependencies
9+
- **Notes** - Decisions, meetings, research, ideas
10+
- **People** - Team members and roles
11+
- **Milestones** - Project goals and deadlines
12+
13+
All data is stored in `.code-hq/graph.jsonld` (JSON-LD format) and queryable via CLI.
14+
15+
## Quick Reference
16+
17+
```bash
18+
# List entities
19+
code-hq tasks # All tasks
20+
code-hq tasks --status blocked # Filtered tasks
21+
code-hq notes # All notes
22+
23+
# Create entities
24+
code-hq create task "Title" --priority high --assignee person:alice
25+
code-hq create note "Title" --note-type decision --content "..."
26+
27+
# Update entities
28+
code-hq update task:123 --status done
29+
code-hq update task:123 --actual-hours 4
30+
31+
# Query (Datalog)
32+
code-hq query "FIND task WHERE ?t.status = 'blocked' RETURN ?t"
33+
34+
# Validate
35+
code-hq validate
36+
```
37+
38+
## Available Guides
39+
40+
- **[task-management.md](./task-management.md)** - Complete guide to managing tasks
41+
- **[note-taking.md](./note-taking.md)** - How to document decisions and research
42+
- **[query-examples.md](./query-examples.md)** - Common queries and patterns
43+
- **[workflows/](./workflows/)** - Automation workflows
44+
45+
## IDE Integration
46+
47+
### Cursor
48+
Add to `.cursorrules`:
49+
```markdown
50+
This project uses code-hq for task management.
51+
Reference .code-hq/prompts/task-management.md for commands.
52+
Always check existing tasks before creating duplicates.
53+
Update task status when starting/finishing work.
54+
```
55+
56+
### Windsurf
57+
Create `.windsurf/workflows/codehq.md`:
58+
```markdown
59+
---
60+
description: code-hq commands reference
61+
---
62+
Read `.code-hq/prompts/_index.md` for overview.
63+
See `.code-hq/prompts/task-management.md` for details.
64+
```
65+
66+
### Claude Code
67+
Automatically sees `.code-hq/prompts/` as context.
68+
Ask: "How do I manage tasks in this project?"
69+
70+
## When to Use code-hq
71+
72+
**Always:**
73+
- Check existing tasks before starting work: `code-hq tasks --status todo`
74+
- Update status when starting work: `code-hq update task:123 --status in-progress`
75+
- Record time spent: `code-hq update task:123 --actual-hours 3`
76+
- Document decisions: `code-hq create note "Why we chose X" --note-type decision`
77+
78+
**When Blocked:**
79+
- Update status: `code-hq update task:123 --status blocked`
80+
- Create blocker note: `code-hq create note "Blocked: Waiting for API keys" --related-to task:123`
81+
82+
**When Completed:**
83+
- Mark done: `code-hq update task:123 --status done`
84+
- Validate graph: `code-hq validate`
85+
86+
## Philosophy
87+
88+
**Structured over Unstructured**: Instead of parsing TODO comments, use semantic tasks.
89+
90+
**Query, Don't Parse**: Use `code-hq query` instead of grepping through files.
91+
92+
**Link Everything**: Tasks → Notes → People → Files. Create relationships.
93+
94+
**Update in Real-Time**: Don't let task status drift from reality.
95+
96+
---
97+
98+
**Next**: Read [task-management.md](./task-management.md) for detailed commands.

0 commit comments

Comments
 (0)