healthy-companion 1.0.3

package/.github/workflows/npm.yml

@@ -0,0 +1,19 @@
+name: Publish on NPM registry
+
+on:
+  push:
+    branches: ['main']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 24.x
+          registry-url: https://registry.npmjs.org/
+      # - run: npm install
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

package/AGENTS.md

@@ -0,0 +1,34 @@
+# Core Rules
+
+The following principles and rules **MUST** always be followed, under all circumstances:
+
+## I. Lightweight Architecture
+
+Code, logic, and architecture **MUST** remain lightweight. Dependencies **MUST** be minimal and purposeful.
+
+## II. Simple and Minimalist Implementation
+
+Code **MUST** be simple, clear, and readable—prefer straightforward, maintainable solutions over complex ones.  
+Keep the codebase minimal: avoid clever or tricky one-liners in favor of clarity.  
+Keep the code clean: avoid duplication.
+
+## III. Developer-Centric Documentation
+
+All documentation **MUST** be developer-focused, with clear, concise technical explanations. Quickstart guides **MUST** enable local setup in under 5 minutes.
+Keep the documentation minimal, and avoid duplication.
+
+## IV. Change Management
+
+When changes are made, update the version in `package.json` and revise documentation (Markdown files) to reflect them.
+
+## V. Comprehensive Change Analysis
+
+When implementing or fixing code, always verify correctness by analyzing related files and dependencies. But never write or run tests.
+
+## VI. Docs-Code Consistency
+
+Documentation and code **MUST** stay in sync:
+
+- Update docs whenever code changes and vice versa if docs are updated.
+- Docs must match real behaviors.
+- Any mismatch between docs and code should be addressed.

package/eslint.config.cjs

@@ -0,0 +1,62 @@
+module.exports = [
+	{
+		languageOptions: {
+			parserOptions: {
+				ecmaVersion: 13,
+				impliedStrict: true,
+			}
+		},
+		rules: {
+			"no-trailing-spaces": "error",
+			"linebreak-style": ["error", "unix"],
+			"quotes": ["error", "double"],
+			"one-var": ["error", "never"],
+			"brace-style": ["error", "allman", { allowSingleLine: true }],
+			"space-before-blocks": "warn",
+			"func-call-spacing": "error",
+			"space-before-function-paren": "error",
+			"space-in-parens": ["error", "always", { exceptions: ["{}"] }],
+			"keyword-spacing": "error",
+			"comma-spacing": "error",
+			"space-unary-ops": "error",
+			"block-spacing": "error",
+			"arrow-spacing": "error",
+			"key-spacing": "error",
+			"comma-style": "error",
+			"space-infix-ops": "error",
+			"array-bracket-spacing": "error",
+			"object-curly-spacing": ["error", "always"],
+			"no-multi-spaces": "error",
+			"operator-linebreak": "error",
+			"function-paren-newline": "warn",
+			"arrow-body-style": ["error", "always"],
+			"no-template-curly-in-string": "error",
+			"no-new-object": "error",
+			"no-extra-parens": ["error", "all", { conditionalAssign: false }],
+			"no-empty-function": "error",
+			"no-empty": ["warn", { allowEmptyCatch: true }],
+			"no-eq-null": "error",
+			"no-extra-bind": "error",
+			"no-self-compare": "error",
+			"no-useless-call": "error",
+			"no-undefined": "error",
+			"no-array-constructor": "error",
+			"prefer-destructuring": ["error",
+				{
+					VariableDeclarator: { array: false, object: true }, AssignmentExpression: { array: false, object: false } }, { enforceForRenamedProperties: false
+				}
+			],
+			"object-shorthand": "warn",
+			"prefer-spread": "warn",
+			"prefer-template": "warn",
+			"no-loop-func": "warn",
+			"prefer-rest-params": "warn",
+			"no-new-func": "warn",
+			"no-unneeded-ternary": "warn",
+			"no-process-exit": "off",
+			"require-await": "warn",
+			"indent": ["error", "tab", { MemberExpression: 0 }],
+			"no-tabs": 0,
+		},
+	},
+];

package/package.json

@@ -0,0 +1,15 @@
+{
+	"name": "healthy-companion",
+	"version": "1.0.3",
+	"type": "module",
+	"description": "A healthy companion MCP server with todo and water tracking",
+	"main": "server.js",
+	"scripts": {
+		"start": "node server.js"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.25.3",
+		"eslint": "^9.39.2",
+		"zod": "^4.3.6"
+	}
+}

package/server.js

@@ -0,0 +1,27 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTodoTools } from "./tools/todo.js";
+
+const server = new McpServer({
+	name: "healthy-companion",
+	version: "1.0.0",
+});
+
+registerTodoTools( server );
+const transport = new StdioServerTransport();
+
+void async function main ()
+{
+	try
+	{
+		const transport = new StdioServerTransport();
+		await server.connect( transport );
+		console.warn( "MCP server is running..." );
+	}
+	catch ( error )
+	{
+		console.error( "Server error:", error );
+		process.exit( 1 );
+
+	}
+}()

package/tools/todo.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+
+const todos = [];
+
+export function registerTodoTools ( server )
+{
+	server.tool(
+		"todo_add",
+		"Add a TODO item",
+		{ item: z.string().describe( "The text of the todo item" ) },
+		async ({ item }) =>
+		{
+			todos.push( item );
+			return {
+				content: [{ type: "text", text: `Added TODO: "${item}"` }],
+			};
+		}
+	);
+
+	server.tool(
+		"todo_list",
+		"List all TODO items",
+		{},
+		async () =>
+		{
+			if ( todos.length === 0 )
+			{
+				return { content: [{ type: "text", text: "No TODO items." }] };
+			}
+			const lines = todos.map( ( todo, idx ) => { return `${idx + 1}. ${todo}` }).join( "\n" );
+			return { content: [{ type: "text", text: lines }] };
+		}
+	);
+
+	server.tool(
+		"todo_remove",
+		"Remove a TODO item by its number",
+		{ index: z.number().int().positive().describe( "1-based index of the item to remove" ) },
+		async ({ index }) =>
+		{
+			const i = index - 1;
+			if ( i < 0 || i >= todos.length )
+			{
+				return { content: [{ type: "text", text: `Invalid index: ${index}` }] };
+			}
+			const removed = todos.splice( i, 1 )[0];
+			return { content: [{ type: "text", text: `Removed TODO: "${removed}"` }] };
+		}
+	);
+}