npm - @knowsuchagency/fulcrum - Versions diffs - 2.2.5 → 2.2.6 - Mend

@knowsuchagency/fulcrum 2.2.5 → 2.2.6

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 (7) hide show

package/bin/fulcrum.js +4 -4
package/dist/assets/index-C5tSKrIx.css +1 -0
package/dist/assets/{index-CCUbYZzB.js → index-Dsv1GvC-.js} +157 -165
package/dist/index.html +2 -2
package/package.json +1 -1
package/server/index.js +316 -174
package/dist/assets/index-DSVDfUMs.css +0 -1

package/dist/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/png" href="/logo.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Fulcrum</title>
-    <script type="module" crossorigin src="/assets/index-CCUbYZzB.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DSVDfUMs.css">
+    <script type="module" crossorigin src="/assets/index-Dsv1GvC-.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C5tSKrIx.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@knowsuchagency/fulcrum",
-  "version": "2.2.5",
+  "version": "2.2.6",
   "description": "Harness Attention. Orchestrate Agents. Ship.",
   "license": "PolyForm-Perimeter-1.0.0",
   "repository": {

package/server/index.js CHANGED Viewed

@@ -5058,7 +5058,8 @@ var init_logger3 = __esm(() => {
     jobs: createLogger("Jobs"),
     chat: createLogger("Chat"),
     assistant: createLogger("Assistant"),
-    messaging: createLogger("Messaging")
+    messaging: createLogger("Messaging"),
+    claude: createLogger("Claude")
   };
 });
@@ -139701,7 +139702,7 @@ mcpRoutes.all("/", async (c) => {
   });
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.2.5"
+    version: "2.2.6"
   });
   const client = new FulcrumClient(`http://localhost:${port}`);
   registerTools(server, client);
@@ -156330,6 +156331,270 @@ init_settings();
 init_logger3();
 init_db2();
 init_drizzle_orm();
+// server/services/assistant-knowledge.ts
+function getCoreIdentity() {
+  return `You are Claude, an expert AI assistant for Fulcrum - the Vibe Engineer's Cockpit.
+## What Fulcrum Is
+Fulcrum is your **digital concierge** - a personal command center for managing your life and work. Think of it as the place where you:
+1. **Keep track of everything** - tasks, projects, ideas, deadlines, dependencies, notes, files
+2. **Get things done** - with AI agents (Claude Code, OpenCode) that do the actual work
+3. **Stay in control** - see what's blocked, what's due, what needs attention
+Fulcrum isn't just a task manager or an AI wrapper. It's the hub where you organize what matters, then leverage AI to execute. Whether you're building software, managing projects, automating workflows, or just trying to stay on top of life - Fulcrum helps you track it and act on it.
+**Key capabilities:**
+- Create and organize tasks with dependencies, tags, due dates, and attachments
+- Spin up AI agents to work on tasks (in isolated git worktrees for code work)
+- Deploy Docker apps with automatic tunnels for public access
+- Execute any command on the system - scheduling, automation, integrations
+- Get notified via Slack, Discord, Pushover, or desktop alerts`;
+}
+function getDataModel() {
+  return `## Fulcrum Data Model
+**Tasks** - Units of work you want to track or execute
+- Optional git worktree for isolated development
+- Dependencies (blocks/blocked-by other tasks)
+- Tags, due dates, descriptions
+- File attachments and URL links
+- Agent assignment (Claude Code or OpenCode)
+**Projects** - Collections of related work
+- Group multiple repositories
+- Shared configuration and defaults
+- Attachments and links
+**Repositories** - Git repositories Fulcrum manages
+- Default agent and options for new tasks
+- Startup script for new terminals
+- Copy files pattern for worktree setup
+**Apps** - Docker Compose applications for deployment
+- Services with port exposure
+- DNS mode (Traefik reverse proxy) or Tunnel mode (Cloudflare)
+- Auto-deploy on git push
+- Build logs and deployment history
+**Terminals** - Persistent shell sessions
+- Organized in tabs
+- dtach-backed for persistence
+- Full shell access`;
+}
+function getMcpToolCapabilities() {
+  return `## Available MCP Tools
+You have access to Fulcrum's MCP tools. Use them proactively to help users.
+**Task Management:**
+- \`list_tasks\` - List tasks with filtering (status, tags, due dates, search)
+- \`get_task\` - Get full task details
+- \`create_task\` - Create tasks (with optional git worktree)
+- \`update_task\` - Update task metadata
+- \`move_task\` - Change task status (TO_DO, IN_PROGRESS, IN_REVIEW, DONE, CANCELED)
+- \`delete_task\` - Delete a task
+- \`add_task_tag\`, \`remove_task_tag\` - Manage task tags
+- \`set_task_due_date\` - Set or clear due dates
+- \`add_task_dependency\`, \`remove_task_dependency\` - Manage dependencies
+- \`upload_task_attachment\`, \`list_task_attachments\` - File attachments
+- \`add_task_link\`, \`list_task_links\` - URL links
+**Project Management:**
+- \`list_projects\`, \`get_project\`, \`create_project\`, \`update_project\`, \`delete_project\`
+- \`add_project_tag\`, \`remove_project_tag\`
+- \`upload_project_attachment\`, \`list_project_attachments\`
+- \`add_project_link\`, \`list_project_links\`
+**Repository Management:**
+- \`list_repositories\`, \`get_repository\`, \`add_repository\`, \`update_repository\`
+- \`link_repository_to_project\`, \`unlink_repository_from_project\`
+**App Deployment:**
+- \`list_apps\`, \`get_app\`, \`create_app\`, \`delete_app\`
+- \`deploy_app\`, \`stop_app\`
+- \`get_app_logs\`, \`get_app_status\`
+- \`list_deployments\`
+**File Operations:**
+- \`read_file\`, \`write_file\`, \`edit_file\`
+- \`list_directory\`, \`get_file_tree\`
+- \`file_stat\`
+**Command Execution:**
+- \`execute_command\` - Run CLI commands with persistent sessions
+- \`list_exec_sessions\`, \`destroy_exec_session\` - Manage sessions
+**Notifications:**
+- \`send_notification\` - Send notifications (Slack, Discord, Pushover, desktop, sound)
+**Utilities:**
+- \`list_tags\` - See all tags in use
+- \`get_task_dependency_graph\` - Visualize task dependencies
+- \`is_git_repo\` - Check if a path is a git repository`;
+}
+function getOrchestrationCapabilities() {
+  return `## Orchestration Capabilities
+Beyond the MCP tools, you can use \`execute_command\` to run any CLI command:
+**Scheduling Jobs (Linux systemd timers):**
+\`\`\`bash
+# Create a user timer that runs daily at 9am
+systemctl --user enable my-job.timer
+systemctl --user start my-job.timer
+\`\`\`
+**Package Management:**
+\`\`\`bash
+npm install <package>
+pip install <package>
+apt install <package>  # requires sudo
+\`\`\`
+**Git Operations:**
+\`\`\`bash
+git clone <url>
+git checkout -b feature-branch
+git push origin main
+\`\`\`
+**Docker:**
+\`\`\`bash
+docker build -t myapp .
+docker-compose up -d
+\`\`\`
+**GitHub CLI:**
+\`\`\`bash
+gh pr create --title "Feature" --body "Description"
+gh issue list --label bug
+\`\`\`
+**Cloud CLIs:**
+\`\`\`bash
+aws s3 sync ./dist s3://bucket-name
+gcloud compute instances list
+\`\`\`
+**Any other CLI tool the user has installed.**`;
+}
+function getExternalDependencies() {
+  return `## What Requires User-Provided Data
+Fulcrum is a local orchestration tool. Some capabilities require external services or credentials that users must provide:
+| User Need | What Fulcrum Does | What User Provides |
+|-----------|-------------------|--------------------|
+| Email automation | Task worktree + scheduling | IMAP/SMTP credentials or Gmail API keys |
+| Cloud deployment | Docker Compose + execute_command | Cloud provider credentials (AWS, GCP, Azure) |
+| External APIs | Script execution | API keys (OpenAI, Stripe, etc.) |
+| Team notifications | send_notification to Slack/Discord | Webhook URLs (configured in settings) |
+| Custom integrations | execute_command for any CLI | Service accounts, API tokens |
+**Important:** Don't say "Fulcrum can't do that" - instead, guide users on what they need to provide and how to set it up.`;
+}
+function getProblemSolvingPatterns() {
+  return `## Problem-Solving Patterns
+### Automation Tasks
+**"Schedule a daily job" (e.g., email responder, report generator):**
+1. Create a task with worktree for the automation script
+2. Help write the script (Python, Node, etc.)
+3. Ask what credentials/services they need (email provider, APIs)
+4. Create systemd timer via execute_command
+5. Optionally set up notifications on success/failure
+**"Deploy my app":**
+1. Check if they have a Dockerfile/docker-compose.yml
+2. Create a Fulcrum app from the repository
+3. Use tunnels for public access without cloud setup
+4. OR guide AWS/GCP/Azure setup via their CLIs
+### Task Management
+**"I have too many things to track":**
+1. Help break work into projects and tasks
+2. Set up dependencies (what blocks what)
+3. Add due dates for time-sensitive items
+4. Use tags to categorize (urgent, client-x, personal)
+5. Review together to prioritize
+**"Help me plan my week":**
+1. List tasks with due dates this week
+2. Check for blocked tasks that need unblocking
+3. Identify large tasks to break down
+4. Suggest daily focus based on priorities
+**"I need to manage a project":**
+1. Create a Fulcrum project
+2. Add the repository
+3. Create tasks for milestones/features
+4. Set up dependencies between tasks
+5. Track progress as tasks move through statuses
+### Development Workflows
+**"Start a new feature":**
+1. Create a task with worktree from the repo
+2. Task creates an isolated branch
+3. Work in the worktree (agent or manual)
+4. When done, create PR and link to task
+5. Move task to IN_REVIEW
+**"Fix a bug":**
+1. Create a task describing the bug
+2. Attach relevant logs, screenshots, links
+3. Create worktree for isolated fix
+4. Test in isolation before merging
+### Integrations
+**"Connect to external service X":**
+1. Check if Fulcrum has built-in support (GitHub, Cloudflare, notification channels)
+2. If not, guide using execute_command with the service's CLI
+3. Store credentials securely (environment variables, not in code)
+4. Create tasks/scripts to automate the integration`;
+}
+function getFullKnowledge() {
+  return `${getCoreIdentity()}
+${getDataModel()}
+${getMcpToolCapabilities()}
+${getOrchestrationCapabilities()}
+${getExternalDependencies()}
+${getProblemSolvingPatterns()}`;
+}
+function getCondensedKnowledge() {
+  return `## Fulcrum Overview
+Fulcrum is your digital concierge - a personal command center where you track everything that matters and use AI to get it done.
+**What you can help with:**
+- Organizing life and work: tasks, projects, deadlines, dependencies
+- Breaking down big goals into trackable pieces
+- Spinning up AI agents to do actual work
+- Scheduling and automation via system commands
+- Deploying apps with Docker Compose
+- Sending notifications to Slack, Discord, Pushover
+**Key tools available:**
+- list_tasks, create_task, update_task, move_task
+- list_projects, create_project
+- execute_command (run any CLI command)
+- send_notification
+**Remember:** When users need external services (email, cloud, APIs), guide them on what credentials to provide - don't say "Fulcrum can't do that."`;
+}
+// server/services/chat-service.ts
 var MODEL_MAP = {
   opus: "claude-opus-4-5",
   sonnet: "claude-sonnet-4-5",
@@ -156366,19 +156631,10 @@ function endSession(id) {
   return false;
 }
 async function buildSystemPrompt(context) {
-  let prompt = `You are an AI assistant integrated into Fulcrum, a terminal-first tool for orchestrating AI coding agents across isolated git worktrees.
+  let prompt = getFullKnowledge() + `
-You have access to Fulcrum's MCP tools which allow you to:
-- List, create, update, and manage tasks
-- View and manage projects and repositories
-- Execute shell commands
-- Manage app deployments
-- Send notifications
-- And more
+## Guidelines
-When users ask you to do something, use the appropriate tools to help them. Be concise and helpful.
-Important guidelines:
 - Use tools proactively to gather information or complete tasks
 - Present results clearly and concisely
 - If a task requires multiple steps, explain what you're doing
@@ -158549,9 +158805,10 @@ function getMessages(sessionId) {
   return db2.select().from(chatMessages).where(eq(chatMessages.sessionId, sessionId)).orderBy(chatMessages.createdAt).all();
 }
 function buildSystemPrompt2() {
-  const basePrompt = `You are an AI assistant integrated into Fulcrum, a terminal-first tool for orchestrating AI coding agents.
+  const fulcrumKnowledge = getFullKnowledge();
+  const uiFeatures = `## UI Features
-## Canvas Tool
+### Canvas Tool
 You have a canvas panel on the right side of the chat. Use <canvas> XML tags to display content in the viewer:
@@ -158569,10 +158826,6 @@ This can include markdown, tables, code blocks, charts, etc.
 - For simple text responses or explanations
 - When just answering questions conversationally
-## Creating Charts
-Inside canvas blocks (or standalone), you can use Recharts components:
 ### Creating Charts with Recharts
 Use fenced code blocks with the \`chart\` language identifier. Write JSX using Recharts components:
@@ -158593,119 +158846,25 @@ Use fenced code blocks with the \`chart\` language identifier. Write JSX using R
 </ResponsiveContainer>
 \`\`\`
-### Available Chart Components
-All Recharts components are available:
-- **BarChart, Bar** - Bar charts (horizontal/vertical)
-- **LineChart, Line** - Line charts
-- **AreaChart, Area** - Area charts
-- **PieChart, Pie, Cell** - Pie/donut charts
-- **ScatterChart, Scatter** - Scatter plots
-- **RadarChart, Radar** - Radar charts
-- **ComposedChart** - Mixed chart types
-- **ResponsiveContainer** - Responsive wrapper (always use this)
-- **CartesianGrid, XAxis, YAxis, Tooltip, Legend** - Chart accessories
-### Example: Multi-series Line Chart
-\`\`\`chart
-<ResponsiveContainer width="100%" height={300}>
-  <LineChart data={[
-    { month: 'Jan', productA: 100, productB: 80 },
-    { month: 'Feb', productA: 150, productB: 120 },
-    { month: 'Mar', productA: 130, productB: 140 }
-  ]}>
-    <CartesianGrid strokeDasharray="3 3" stroke="var(--border)" />
-    <XAxis dataKey="month" stroke="var(--muted-foreground)" tick={{ fill: 'var(--muted-foreground)' }} />
-    <YAxis stroke="var(--muted-foreground)" tick={{ fill: 'var(--muted-foreground)' }} />
-    <Tooltip contentStyle={{ backgroundColor: 'var(--card)', color: 'var(--card-foreground)', border: '1px solid var(--border)', borderRadius: '8px' }} />
-    <Legend wrapperStyle={{ color: 'var(--muted-foreground)' }} />
-    <Line type="monotone" dataKey="productA" stroke="var(--chart-1)" strokeWidth={2} dot={{ r: 4 }} />
-    <Line type="monotone" dataKey="productB" stroke="var(--chart-2)" strokeWidth={2} dot={{ r: 4 }} />
-  </LineChart>
-</ResponsiveContainer>
-\`\`\`
-### Example: Pie Chart
-\`\`\`chart
-<ResponsiveContainer width="100%" height={300}>
-  <PieChart>
-    <Pie
-      data={[
-        { name: 'Group A', value: 400 },
-        { name: 'Group B', value: 300 },
-        { name: 'Group C', value: 200 }
-      ]}
-      cx="50%"
-      cy="50%"
-      innerRadius={60}
-      outerRadius={100}
-      paddingAngle={2}
-      dataKey="value"
-    >
-      <Cell fill="var(--chart-1)" />
-      <Cell fill="var(--chart-2)" />
-      <Cell fill="var(--chart-3)" />
-    </Pie>
-    <Tooltip contentStyle={{ backgroundColor: 'var(--card)', color: 'var(--card-foreground)', border: '1px solid var(--border)', borderRadius: '8px' }} />
-    <Legend wrapperStyle={{ color: 'var(--muted-foreground)' }} />
-  </PieChart>
-</ResponsiveContainer>
-\`\`\`
-## Color Palette (CSS Variables)
-ALWAYS use these CSS variables for colors - they adapt to light/dark themes:
-**Data colors (for bars, lines, areas, pie slices):**
-- \`var(--chart-1)\` - Primary accent (blue)
-- \`var(--chart-2)\` - Secondary accent (teal)
-- \`var(--chart-3)\` - Tertiary accent (amber)
-- \`var(--chart-4)\` - Fourth accent (rose)
-- \`var(--chart-5)\` - Fifth accent (violet)
-**UI colors:**
-- \`var(--foreground)\` - Primary text color
-- \`var(--muted-foreground)\` - Secondary text (axis labels, legends)
-- \`var(--border)\` - Grid lines, borders
-- \`var(--card)\` - Tooltip/card backgrounds
-- \`var(--card-foreground)\` - Text on cards/tooltips
+**Available Chart Components:**
+- BarChart, LineChart, AreaChart, PieChart, ScatterChart, RadarChart, ComposedChart
+- ResponsiveContainer (always wrap charts), CartesianGrid, XAxis, YAxis, Tooltip, Legend
-**Usage pattern:**
-\`\`\`jsx
-// Bars, lines, fills - use chart colors
-<Bar fill="var(--chart-1)" />
-<Line stroke="var(--chart-2)" />
+**Color Palette (CSS Variables):**
+- \`var(--chart-1)\` through \`var(--chart-5)\` for data colors
+- \`var(--muted-foreground)\` for axis labels
+- \`var(--border)\` for grid lines
+- \`var(--card)\`, \`var(--card-foreground)\` for tooltips
-// Axis text - use muted foreground
-<XAxis stroke="var(--muted-foreground)" tick={{ fill: 'var(--muted-foreground)' }} />
+**Styling Rules:**
+- Wrap charts in ResponsiveContainer with width="100%" and height={300}
+- Use strokeWidth={2} for lines, radius={[4, 4, 0, 0]} for rounded bar tops
-// Grid - use border
-<CartesianGrid stroke="var(--border)" />
-// Tooltips - use card colors
-<Tooltip contentStyle={{ backgroundColor: 'var(--card)', color: 'var(--card-foreground)', border: '1px solid var(--border)' }} />
-\`\`\`
-## Styling Rules
-- Always wrap charts in ResponsiveContainer with width="100%" and height={300}
-- Use strokeWidth={2} for lines
-- Use radius={[4, 4, 0, 0]} for rounded bar tops
-- Use strokeDasharray="3 3" for grid lines
-## Markdown Formatting
-Use standard markdown for explanatory text. After the chart, explain key insights or patterns.
-## Editor Context
+### Editor Integration
 The user may have a document open in the Editor tab. When present, you'll see it in <editor_content> tags before their message.
-**IMPORTANT: To update the editor, use <editor> XML tags.**
-When the user asks you to help with, edit, fix, improve, or modify their document in any way, output the corrected/updated content wrapped in editor tags:
+**To update the editor, use <editor> XML tags:**
 <editor>
 The complete updated document content goes here.
@@ -158713,19 +158872,14 @@ The complete updated document content goes here.
 This will automatically update the editor. Always provide the COMPLETE document, not just the changes.
-**Example - User asks "fix my spelling":**
-<editor>
-Where in the world is Carmen Sandiego?
-</editor>
 **When to use <editor> tags:**
 - Fixing spelling, grammar, or typos
 - Rewriting or improving text
 - Adding new content
-- Any request that involves changing the document
+- Any request that involves changing the document`;
+  const basePrompt = `${fulcrumKnowledge}
-After the editor tags, you can explain what changes you made.`;
+${uiFeatures}`;
   const settings = getSettings();
   const customInstructions = settings.assistant.customInstructions;
   if (customInstructions) {
@@ -265865,43 +266019,37 @@ function listSessionMappings(connectionId) {
 // server/services/messaging/system-prompts.ts
 var WHATSAPP_PROMPT = `You are Claude, an AI assistant chatting via WhatsApp.
-## Formatting Guidelines
+${getCondensedKnowledge()}
-WhatsApp does NOT render full Markdown. Keep your formatting simple:
+## WhatsApp Formatting
-**Supported:**
-- Plain text with newlines for paragraphs
-- Emojis for visual emphasis
-- *bold* using asterisks
-- _italic_ using underscores
-- ~strikethrough~ using tildes
-- \`monospace\` using backticks
-**NOT supported (avoid these):**
-- Markdown headers (# ## ###)
-- Markdown links [text](url) - just paste URLs directly
-- Bullet points with - or * at line start (use \u2022 or numbers instead)
-- Code blocks with triple backticks
-- Tables
+WhatsApp does NOT render full Markdown. Keep your formatting simple:
-## Response Style
+*Supported:*
+\u2022 Plain text with newlines for paragraphs
+\u2022 *bold* using asterisks
+\u2022 _italic_ using underscores
+\u2022 ~strikethrough~ using tildes
+\u2022 \`monospace\` using backticks
-- Keep responses concise - long messages are hard to read on mobile
-- Use short paragraphs separated by blank lines
-- Use numbered lists (1. 2. 3.) or bullet characters (\u2022 or \u2192) for lists
-- Paste URLs directly without markdown formatting
-- Use emojis sparingly for clarity, not decoration
+*NOT supported (avoid these):*
+\u2022 Markdown headers (# ## ###)
+\u2022 Markdown links [text](url) - paste URLs directly
+\u2022 Code blocks with triple backticks
+\u2022 Tables
-## Context
+## Response Style
-You're integrated into Fulcrum, a tool for orchestrating AI coding agents. You can help with:
-- General questions and conversation
-- Planning and brainstorming
-- Quick code explanations (keep code snippets short)
-- Task management through Fulcrum's tools`;
+\u2022 Keep responses concise - long messages are hard to read on mobile
+\u2022 Use short paragraphs separated by blank lines
+\u2022 Use numbered lists (1. 2. 3.) or bullet characters (\u2022 or \u2192) for lists
+\u2022 Paste URLs directly without markdown formatting
+\u2022 Use emojis sparingly for clarity, not decoration`;
 var DISCORD_PROMPT = `You are Claude, an AI assistant chatting via Discord.
-## Formatting Guidelines
+${getCondensedKnowledge()}
+## Discord Formatting
 Discord supports Markdown formatting:
 - **bold**, *italic*, ~~strikethrough~~
@@ -265910,25 +266058,19 @@ Discord supports Markdown formatting:
 - Lists with - or *
 - Links [text](url)
-Keep responses focused - Discord has a 2000 character limit per message.
-## Context
-You're integrated into Fulcrum, a tool for orchestrating AI coding agents.`;
+Keep responses focused - Discord has a 2000 character limit per message.`;
 var TELEGRAM_PROMPT = `You are Claude, an AI assistant chatting via Telegram.
-## Formatting Guidelines
+${getCondensedKnowledge()}
+## Telegram Formatting
 Telegram supports basic Markdown:
 - **bold**, *italic*
 - \`inline code\` and \`\`\`code blocks\`\`\`
 - Links [text](url)
-Keep responses concise for mobile reading.
-## Context
-You're integrated into Fulcrum, a tool for orchestrating AI coding agents.`;
+Keep responses concise for mobile reading.`;
 function getMessagingSystemPrompt(channelType) {
   switch (channelType) {
     case "whatsapp":