@assistkick/create 1.2.0 → 1.3.0

package/templates/skills/assistkick-bootstrap/SKILL.md

@@ -181,37 +181,45 @@ from the features they apply to.
 3. Call `end_session` with a summary
 4. Tell the user which phase to resume at next session
 
+## Project ID
+
+All tools require `--project-id <project_id>`. Resolve it at session start:
+- If the user passed a project ID in the invocation arguments → use it directly
+- Otherwise → ask the user: "Which project ID should I use?"
+
+Use the same `<project_id>` on **every** tool call in this session.
+
 ## Tool Reference
 
 ### start_session
 ```
-npx tsx packages/shared/tools/start_session.ts
+npx tsx packages/shared/tools/start_session.ts --project-id <project_id>
 ```
 
 ### end_session
 ```
-npx tsx packages/shared/tools/end_session.ts --summary "..." --nodes-touched "feat_001,dec_001" --questions-resolved 3
+npx tsx packages/shared/tools/end_session.ts --project-id <project_id> --summary "..." --nodes-touched "feat_001,dec_001" --questions-resolved 3
 ```
 
 ### search_nodes
 ```
-npx tsx packages/shared/tools/search_nodes.ts --query "keyword"
-npx tsx packages/shared/tools/search_nodes.ts --type feature
-npx tsx packages/shared/tools/search_nodes.ts --has-open-questions
-npx tsx packages/shared/tools/search_nodes.ts --completeness-below 0.5
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --query "keyword"
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --type feature
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --has-open-questions
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --completeness-below 0.5
 ```
 
 ### get_node
 ```
-npx tsx packages/shared/tools/get_node.ts <node_id>
-npx tsx packages/shared/tools/get_node.ts --name "Node Name"
+npx tsx packages/shared/tools/get_node.ts <node_id> --project-id <project_id>
+npx tsx packages/shared/tools/get_node.ts --name "Node Name" --project-id <project_id>
 ```
 Returns full .md content plus a Relations section listing all connected nodes
 with direction, relation type, name, type, and status.
 
 ### add_node
 ```
-npx tsx packages/shared/tools/add_node.ts --type <type> --name "Name" --description "..."
+npx tsx packages/shared/tools/add_node.ts --project-id <project_id> --type <type> --name "Name" --description "..."
 ```
 Valid types: feature, component, data_entity, decision, tech_choice,
 non_functional_requirement, design_token, design_pattern, user_role,
@@ -219,23 +227,23 @@ flow, assumption, open_question
 
 ### update_node
 ```
-npx tsx packages/shared/tools/update_node.ts <id> --add-acceptance-criteria "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-open-question "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-note "Session N: ..."
-npx tsx packages/shared/tools/update_node.ts <id> --set-status <draft|partially_defined|defined>
-npx tsx packages/shared/tools/update_node.ts <id> --set-priority <low|medium|high|blocking>
-npx tsx packages/shared/tools/update_node.ts <id> --set-description "..."
-npx tsx packages/shared/tools/update_node.ts <id> --set-section "SectionName=content"
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-acceptance-criteria "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-open-question "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-note "Session N: ..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-status <draft|partially_defined|defined>
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-priority <low|medium|high|blocking>
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-description "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-section "SectionName=content"
 ```
 
 ### resolve_question
 ```
-npx tsx packages/shared/tools/resolve_question.ts <id> --question "..." --answer "..."
+npx tsx packages/shared/tools/resolve_question.ts <id> --project-id <project_id> --question "..." --answer "..."
 ```
 
 ### add_edge
 ```
-npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id>
+npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id> --project-id <project_id>
 ```
 Valid relations: contains, depends_on, governed_by, constrained_by,
 implemented_with, reads_writes, exposes, consumes, performed_by,
@@ -243,25 +251,25 @@ escalates_to, relates_to
 
 ### remove_edge
 ```
-npx tsx packages/shared/tools/remove_edge.ts <from_id> <relation> <to_id>
+npx tsx packages/shared/tools/remove_edge.ts <from_id> <relation> <to_id> --project-id <project_id>
 ```
 
 ### get_gaps
 ```
-npx tsx packages/shared/tools/get_gaps.ts
-npx tsx packages/shared/tools/get_gaps.ts --blocking-only
-npx tsx packages/shared/tools/get_gaps.ts --type feature
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id>
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id> --blocking-only
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id> --type feature
 ```
 
 ### get_status
 ```
-npx tsx packages/shared/tools/get_status.ts
+npx tsx packages/shared/tools/get_status.ts --project-id <project_id>
 ```
 
 ### rebuild_index
 ```
-npx tsx packages/shared/tools/rebuild_index.ts
-npx tsx packages/shared/tools/rebuild_index.ts --dry-run
+npx tsx packages/shared/tools/rebuild_index.ts --project-id <project_id>
+npx tsx packages/shared/tools/rebuild_index.ts --project-id <project_id> --dry-run
 ```
 
 ## Search Strategy

package/templates/skills/assistkick-code-reviewer/SKILL.md

@@ -72,14 +72,14 @@ After reviewing, you MUST take exactly one action:
 ### Approve
 If the feature delivers what was requested and passes all checks:
 ```
-npx tsx packages/shared/tools/move_card.ts <feat_id> qa
+npx tsx packages/shared/tools/move_card.ts <feat_id> qa --project-id <project_id>
 ```
 Report to the user: what was reviewed, how it integrates with existing features, and that it passed.
 
 ### Reject
 If any check fails — especially if the feature does not deliver what was requested:
 ```
-npx tsx packages/shared/tools/move_card.ts <feat_id> todo --note "Clear description of what needs fixing"
+npx tsx packages/shared/tools/move_card.ts <feat_id> todo --project-id <project_id> --note "Clear description of what needs fixing"
 ```
 The note MUST be actionable — reference specific acceptance criteria that are not met,
 specific integration issues with existing features, or specific connected node requirements
@@ -91,48 +91,56 @@ Your transitions:
 - **In Review → QA**: Feature passes review (approve)
 - **In Review → Todo**: Feature fails review (reject with notes)
 
+## Project ID
+
+All tools require `--project-id <project_id>`. Resolve it at session start:
+- If the user passed a project ID in the invocation arguments → use it directly
+- Otherwise → ask the user: "Which project ID should I use?"
+
+Use the same `<project_id>` on **every** tool call in this session.
+
 ## Tool Reference
 
 ### get_kanban
 ```
-npx tsx packages/shared/tools/get_kanban.ts                    # show all columns
-npx tsx packages/shared/tools/get_kanban.ts --column in_review # features awaiting review
-npx tsx packages/shared/tools/get_kanban.ts --column done      # already shipped features
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id>                    # show all columns
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column in_review # features awaiting review
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column done      # already shipped features
 ```
 
 ### move_card
 ```
-npx tsx packages/shared/tools/move_card.ts <feature_id> qa                            # approve
-npx tsx packages/shared/tools/move_card.ts <feature_id> todo --note "What to fix"     # reject
+npx tsx packages/shared/tools/move_card.ts <feature_id> qa --project-id <project_id>                            # approve
+npx tsx packages/shared/tools/move_card.ts <feature_id> todo --project-id <project_id> --note "What to fix"     # reject
 ```
 
 ### get_node
 ```
-npx tsx packages/shared/tools/get_node.ts <node_id>
-npx tsx packages/shared/tools/get_node.ts --name "Node Name"
+npx tsx packages/shared/tools/get_node.ts <node_id> --project-id <project_id>
+npx tsx packages/shared/tools/get_node.ts --name "Node Name" --project-id <project_id>
 ```
 Returns full .md content plus a Relations section listing all connected nodes with direction, relation type, name, type, and status.
 
 ### search_nodes
 ```
-npx tsx packages/shared/tools/search_nodes.ts --query "keyword"
-npx tsx packages/shared/tools/search_nodes.ts --type feature
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --query "keyword"
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --type feature
 ```
 
 ### update_node
 ```
-npx tsx packages/shared/tools/update_node.ts <id> --add-note "Review: ..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-open-question "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-note "Review: ..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-open-question "..."
 ```
 
 ### get_gaps
 ```
-npx tsx packages/shared/tools/get_gaps.ts
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id>
 ```
 
 ### get_status
 ```
-npx tsx packages/shared/tools/get_status.ts
+npx tsx packages/shared/tools/get_status.ts --project-id <project_id>
 ```
 
 ## Rules

package/templates/skills/assistkick-db-explorer/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: assistkick-db-explorer
+description: Explore and inspect the database with read-only access. Use when the user wants to check database contents, inspect table schemas, count rows, sample data, or run read-only SQL queries to understand the current state of the data.
+---
+
+# Database Explorer Skill
+
+## Your Role
+You are a database inspector. You use the `db_explorer` tool to help the user
+understand the current state of the database — table structures, row counts,
+data samples, and custom read-only queries. You have absolutely NO write
+capabilities. You can only read and inspect.
+
+All commands are run from the `assistkick-product-system/` directory.
+
+## Tool Reference
+
+### List all tables
+```
+npx tsx packages/shared/tools/db_explorer.ts tables
+```
+Shows all tables with row counts.
+
+### Describe a table schema
+```
+npx tsx packages/shared/tools/db_explorer.ts describe <table_name>
+```
+Shows columns, types, nullability, defaults, primary keys, indexes, and foreign keys.
+
+### Count rows
+```
+npx tsx packages/shared/tools/db_explorer.ts count <table_name>
+npx tsx packages/shared/tools/db_explorer.ts count <table_name> --where "status = 'draft'"
+npx tsx packages/shared/tools/db_explorer.ts count <table_name> --where "project_id = 'proj_001'"
+```
+
+### Sample rows
+```
+npx tsx packages/shared/tools/db_explorer.ts sample <table_name>
+npx tsx packages/shared/tools/db_explorer.ts sample <table_name> --limit 5
+npx tsx packages/shared/tools/db_explorer.ts sample <table_name> --where "type = 'feature'" --limit 3
+npx tsx packages/shared/tools/db_explorer.ts sample <table_name> --order-by "created_at DESC" --limit 5
+```
+
+### Run a read-only SQL query
+```
+npx tsx packages/shared/tools/db_explorer.ts query "SELECT id, name, type, status FROM nodes WHERE type = 'feature'"
+npx tsx packages/shared/tools/db_explorer.ts query "SELECT n.id, n.name, k.column_name FROM nodes n JOIN kanban k ON n.id = k.node_id"
+npx tsx packages/shared/tools/db_explorer.ts query "SELECT type, COUNT(*) as cnt FROM nodes GROUP BY type ORDER BY cnt DESC"
+npx tsx packages/shared/tools/db_explorer.ts query "PRAGMA table_info('nodes')"
+```
+Only SELECT, PRAGMA, and EXPLAIN queries are allowed. Write operations are blocked.
+A safety LIMIT of 100 is auto-appended to SELECT queries without an explicit LIMIT.
+
+## Available Tables
+
+| Table | Description |
+|-------|-------------|
+| `nodes` | Knowledge graph nodes (features, components, decisions, etc.) |
+| `edges` | Relationships between nodes |
+| `kanban` | Feature kanban board state |
+| `sessions` | Interview session history |
+| `coherence_reviews` | Graph change proposals |
+| `review_meta` | Kanban metadata and review state |
+| `users` | User accounts |
+| `refresh_tokens` | JWT refresh tokens |
+| `password_reset_tokens` | Password reset flow |
+| `invitations` | User invitations |
+| `projects` | Project contexts |
+| `pipeline_state` | Pipeline execution state |
+
+## Security
+
+- Only SELECT, PRAGMA, and EXPLAIN queries are allowed
+- Write keywords (INSERT, UPDATE, DELETE, DROP, ALTER, CREATE, etc.) are blocked
+- Multiple statements (semicolons) are blocked
+- Sensitive columns (`password_hash`, `token_hash`) are automatically redacted as `[REDACTED]`
+- SQL comments are stripped before validation
+
+## Rules
+1. Never attempt write operations — the tool will reject them
+2. Use `--where` to filter results rather than dumping entire tables
+3. Use `--limit` to keep output manageable
+4. The `--project-id` flag is optional — use `--where "project_id = '...'"` to filter by project
+5. All tool commands must be run from the `assistkick-product-system/` directory
+6. Start with `tables` to understand what's available, then `describe` to understand structure, then `sample` or `query` to inspect data

package/templates/skills/assistkick-debugger/SKILL.md

@@ -104,17 +104,17 @@ Once you've found the root cause, create a bugfix feature:
 
 1. **Create the bugfix feature** with a clear description of the problem and root cause:
 ```
-npx tsx packages/shared/tools/add_node.ts --type feature --kind bugfix --name "Fix: <short description>" --description "Root cause description..."
+npx tsx packages/shared/tools/add_node.ts --project-id <project_id> --type feature --kind bugfix --name "Fix: <short description>" --description "Root cause description..."
 ```
 
 2. **Add acceptance criteria** that describe the correct behavior:
 ```
-npx tsx packages/shared/tools/update_node.ts <new_feat_id> --add-acceptance-criteria "..."
+npx tsx packages/shared/tools/update_node.ts <new_feat_id> --project-id <project_id> --add-acceptance-criteria "..."
 ```
 
 3. **Add investigation notes** with root cause details, code locations, and fix guidance:
 ```
-npx tsx packages/shared/tools/update_node.ts <new_feat_id> --add-note "Investigation: ..."
+npx tsx packages/shared/tools/update_node.ts <new_feat_id> --project-id <project_id> --add-note "Investigation: ..."
 ```
 The note should include:
 - Reproduction steps
@@ -124,71 +124,79 @@ The note should include:
 
 4. **Link the bugfix** to the affected feature(s):
 ```
-npx tsx packages/shared/tools/add_edge.ts <new_feat_id> relates_to <affected_feat_id>
+npx tsx packages/shared/tools/add_edge.ts <new_feat_id> relates_to <affected_feat_id> --project-id <project_id>
 ```
 
 5. **Report findings** to the user with a summary of the root cause and the bugfix feature ID
 
+## Project ID
+
+All tools require `--project-id <project_id>`. Resolve it at session start:
+- If the user passed a project ID in the invocation arguments → use it directly
+- Otherwise → ask the user: "Which project ID should I use?"
+
+Use the same `<project_id>` on **every** tool call in this session.
+
 ## Tool Reference
 
 ### get_kanban
 ```
-npx tsx packages/shared/tools/get_kanban.ts                    # show all columns
-npx tsx packages/shared/tools/get_kanban.ts --column qa        # features in QA
-npx tsx packages/shared/tools/get_kanban.ts --column done      # shipped features
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id>                    # show all columns
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column qa        # features in QA
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column done      # shipped features
 ```
 
 ### move_card
 ```
-npx tsx packages/shared/tools/move_card.ts <feature_id> todo --note "Bug found — see feat_NNN for details"
+npx tsx packages/shared/tools/move_card.ts <feature_id> todo --project-id <project_id> --note "Bug found — see feat_NNN for details"
 ```
 
 ### get_node
 ```
-npx tsx packages/shared/tools/get_node.ts <node_id>
-npx tsx packages/shared/tools/get_node.ts --name "Node Name"
+npx tsx packages/shared/tools/get_node.ts <node_id> --project-id <project_id>
+npx tsx packages/shared/tools/get_node.ts --name "Node Name" --project-id <project_id>
 ```
 Returns full .md content plus a Relations section listing all connected nodes with direction, relation type, name, type, and status.
 
 ### search_nodes
 ```
-npx tsx packages/shared/tools/search_nodes.ts --query "keyword"
-npx tsx packages/shared/tools/search_nodes.ts --type feature
-npx tsx packages/shared/tools/search_nodes.ts --has-open-questions
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --query "keyword"
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --type feature
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --has-open-questions
 ```
 
 ### add_node
 ```
-npx tsx packages/shared/tools/add_node.ts --type feature --kind bugfix --name "Fix: ..." --description "..."
+npx tsx packages/shared/tools/add_node.ts --project-id <project_id> --type feature --kind bugfix --name "Fix: ..." --description "..."
 ```
 Use `--kind bugfix` when creating bug features.
 
 ### update_node
 ```
-npx tsx packages/shared/tools/update_node.ts <id> --add-acceptance-criteria "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-open-question "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-note "Investigation: ..."
-npx tsx packages/shared/tools/update_node.ts <id> --set-description "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-acceptance-criteria "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-open-question "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-note "Investigation: ..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-description "..."
 ```
 
 ### add_edge
 ```
-npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id>
+npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id> --project-id <project_id>
 ```
 
 ### resolve_question
 ```
-npx tsx packages/shared/tools/resolve_question.ts <id> --question "..." --answer "..."
+npx tsx packages/shared/tools/resolve_question.ts <id> --project-id <project_id> --question "..." --answer "..."
 ```
 
 ### get_gaps
 ```
-npx tsx packages/shared/tools/get_gaps.ts
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id>
 ```
 
 ### get_status
 ```
-npx tsx packages/shared/tools/get_status.ts
+npx tsx packages/shared/tools/get_status.ts --project-id <project_id>
 ```
 
 ## Rules

package/templates/skills/assistkick-developer/SKILL.md

@@ -72,18 +72,26 @@ Features may be sent back to `todo` with rejection notes:
 ### Browser Support
 - Latest Chrome and Firefox
 
+## Project ID
+
+All tools require `--project-id <project_id>`. Resolve it at session start:
+- If the user passed a project ID in the invocation arguments → use it directly
+- Otherwise → ask the user: "Which project ID should I use?"
+
+Use the same `<project_id>` on **every** tool call in this session.
+
 ## Tool Reference
 
 ### get_kanban
 ```
-npx tsx packages/shared/tools/get_kanban.ts                    # show all columns
-npx tsx packages/shared/tools/get_kanban.ts --column todo      # only todo items
-npx tsx packages/shared/tools/get_kanban.ts --column qa        # only qa items
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id>                    # show all columns
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column todo      # only todo items
+npx tsx packages/shared/tools/get_kanban.ts --project-id <project_id> --column qa        # only qa items
 ```
 
 ### move_card
 ```
-npx tsx packages/shared/tools/move_card.ts <feature_id> <target_column>
+npx tsx packages/shared/tools/move_card.ts <feature_id> <target_column> --project-id <project_id>
 ```
 Your allowed transitions:
 - `todo` → `in_progress`
@@ -91,32 +99,32 @@ Your allowed transitions:
 
 ### start_session
 ```
-npx tsx packages/shared/tools/start_session.ts
+npx tsx packages/shared/tools/start_session.ts --project-id <project_id>
 ```
 
 ### end_session
 ```
-npx tsx packages/shared/tools/end_session.ts --summary "..." --nodes-touched "feat_001,dec_001" --questions-resolved 3
+npx tsx packages/shared/tools/end_session.ts --project-id <project_id> --summary "..." --nodes-touched "feat_001,dec_001" --questions-resolved 3
 ```
 
 ### search_nodes
 ```
-npx tsx packages/shared/tools/search_nodes.ts --query "keyword"
-npx tsx packages/shared/tools/search_nodes.ts --type feature
-npx tsx packages/shared/tools/search_nodes.ts --has-open-questions
-npx tsx packages/shared/tools/search_nodes.ts --completeness-below 0.5
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --query "keyword"
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --type feature
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --has-open-questions
+npx tsx packages/shared/tools/search_nodes.ts --project-id <project_id> --completeness-below 0.5
 ```
 
 ### get_node
 ```
-npx tsx packages/shared/tools/get_node.ts <node_id>
-npx tsx packages/shared/tools/get_node.ts --name "Node Name"
+npx tsx packages/shared/tools/get_node.ts <node_id> --project-id <project_id>
+npx tsx packages/shared/tools/get_node.ts --name "Node Name" --project-id <project_id>
 ```
 Returns full .md content plus a Relations section listing all connected nodes with direction, relation type, name, type, and status.
 
 ### add_node
 ```
-npx tsx packages/shared/tools/add_node.ts --type <type> --name "Name" --description "..."
+npx tsx packages/shared/tools/add_node.ts --project-id <project_id> --type <type> --name "Name" --description "..."
 ```
 Valid types: feature, component, data_entity, decision, tech_choice,
 non_functional_requirement, design_token, design_pattern, user_role,
@@ -124,23 +132,23 @@ flow, assumption, open_question
 
 ### update_node
 ```
-npx tsx packages/shared/tools/update_node.ts <id> --add-acceptance-criteria "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-open-question "..."
-npx tsx packages/shared/tools/update_node.ts <id> --add-note "Session N: ..."
-npx tsx packages/shared/tools/update_node.ts <id> --set-status <draft|partially_defined|defined>
-npx tsx packages/shared/tools/update_node.ts <id> --set-priority <low|medium|high|blocking>
-npx tsx packages/shared/tools/update_node.ts <id> --set-description "..."
-npx tsx packages/shared/tools/update_node.ts <id> --set-section "SectionName=content"
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-acceptance-criteria "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-open-question "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --add-note "Session N: ..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-status <draft|partially_defined|defined>
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-priority <low|medium|high|blocking>
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-description "..."
+npx tsx packages/shared/tools/update_node.ts <id> --project-id <project_id> --set-section "SectionName=content"
 ```
 
 ### resolve_question
 ```
-npx tsx packages/shared/tools/resolve_question.ts <id> --question "..." --answer "..."
+npx tsx packages/shared/tools/resolve_question.ts <id> --project-id <project_id> --question "..." --answer "..."
 ```
 
 ### add_edge
 ```
-npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id>
+npx tsx packages/shared/tools/add_edge.ts <from_id> <relation> <to_id> --project-id <project_id>
 ```
 Valid relations: contains, depends_on, governed_by, constrained_by,
 implemented_with, reads_writes, exposes, consumes, performed_by,
@@ -148,25 +156,25 @@ escalates_to, relates_to
 
 ### remove_edge
 ```
-npx tsx packages/shared/tools/remove_edge.ts <from_id> <relation> <to_id>
+npx tsx packages/shared/tools/remove_edge.ts <from_id> <relation> <to_id> --project-id <project_id>
 ```
 
 ### get_gaps
 ```
-npx tsx packages/shared/tools/get_gaps.ts
-npx tsx packages/shared/tools/get_gaps.ts --blocking-only
-npx tsx packages/shared/tools/get_gaps.ts --type feature
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id>
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id> --blocking-only
+npx tsx packages/shared/tools/get_gaps.ts --project-id <project_id> --type feature
 ```
 
 ### get_status
 ```
-npx tsx packages/shared/tools/get_status.ts
+npx tsx packages/shared/tools/get_status.ts --project-id <project_id>
 ```
 
 ### rebuild_index
 ```
-npx tsx packages/shared/tools/rebuild_index.ts
-npx tsx packages/shared/tools/rebuild_index.ts --dry-run
+npx tsx packages/shared/tools/rebuild_index.ts --project-id <project_id>
+npx tsx packages/shared/tools/rebuild_index.ts --project-id <project_id> --dry-run
 ```
 
 ## Rules