@tac0de/project-bootstrap-mcp 1.1.0 → 1.1.2

package/dist/bin/project-bootstrap-mcp.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=project-bootstrap-mcp.d.ts.map

package/dist/bin/project-bootstrap-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-mcp.d.ts","sourceRoot":"","sources":["../../bin/project-bootstrap-mcp.ts"],"names":[],"mappings":""}

package/dist/bin/project-bootstrap-mcp.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = __importDefault(require("../src/server.js"));
+function parsePort(args, envPort) {
+    let portValue = envPort || '4000';
+    args.forEach((arg, index, list) => {
+        if (arg === '--port' && list[index + 1]) {
+            portValue = list[index + 1];
+        }
+        if (arg.startsWith('--port=')) {
+            portValue = arg.split('=')[1];
+        }
+        if (arg === '-p' && list[index + 1]) {
+            portValue = list[index + 1];
+        }
+    });
+    const parsed = Number.parseInt(portValue, 10);
+    if (Number.isNaN(parsed)) {
+        console.error(`invalid port value: ${portValue}`);
+        process.exit(1);
+    }
+    return parsed;
+}
+const port = parsePort(process.argv.slice(2), process.env.PORT);
+(0, server_js_1.default)({ port });

package/dist/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@tac0de/project-bootstrap-mcp",
+    "version": "1.1.2",
+    "description": "Project Bootstrap MCP API tooling for launching MCP bootstrap definitions and documentation.",
+    "main": "dist/index.js",
+    "bin": {
+        "project-bootstrap-mcp": "bin/project-bootstrap-mcp.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "start": "npm run build && node ./bin/project-bootstrap-mcp.js",
+        "test": "node --test -r ts-node/register test/store.test.ts"
+    },
+    "keywords": [
+        "mcp",
+        "bootstrap",
+        "api",
+        "cli",
+        "project-tools"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "author": "wonyoung choi",
+    "license": "MIT",
+    "type": "commonjs",
+    "engines": {
+        "node": ">=18"
+    },
+    "files": [
+        "bin",
+        "dist",
+        "src",
+        "test",
+        "LICENSE",
+        "README.md",
+        "TRD.md"
+    ],
+    "types": "dist/index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/tac0de/project-bootstrap-mcp"
+    },
+    "dependencies": {
+        "express": "^4.19.2"
+    },
+    "devDependencies": {
+        "@types/express": "^5.0.6",
+        "@types/node": "^25.0.3",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.9.3"
+    }
+}

package/dist/src/app.d.ts

@@ -0,0 +1,11 @@
+import express from 'express';
+import BootstrapStore from './store';
+interface CreateAppOptions {
+    store?: BootstrapStore;
+}
+export default function createApp(options?: CreateAppOptions): {
+    app: express.Express;
+    store: BootstrapStore;
+};
+export {};
+//# sourceMappingURL=app.d.ts.map

package/dist/src/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAqD,MAAM,SAAS,CAAC;AAG5E,OAAO,cAAc,MAAM,SAAS,CAAC;AAGrC,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,OAAO,GAAE,gBAAqB;;;EA8D/D"}

package/dist/src/app.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createApp;
+const express_1 = __importDefault(require("express"));
+const package_json_1 = __importDefault(require("../package.json"));
+const validators_1 = require("./validators");
+const store_1 = __importDefault(require("./store"));
+function createApp(options = {}) {
+    const store = options.store ?? new store_1.default();
+    const app = (0, express_1.default)();
+    app.use(express_1.default.json());
+    app.get('/api/status', (_req, res) => {
+        res.json({
+            service: package_json_1.default.name,
+            version: package_json_1.default.version,
+            uptime: process.uptime(),
+            timestamp: new Date().toISOString(),
+        });
+    });
+    app.get('/api/bootstraps', (_req, res) => {
+        res.json({ items: store.list() });
+    });
+    app.post('/api/bootstraps', (req, res) => {
+        const validation = (0, validators_1.validateBootstrapPayload)(req.body);
+        if (!validation.valid) {
+            return res.status(400).json({ errors: validation.errors });
+        }
+        const payload = {
+            name: req.body.name,
+            description: req.body.description,
+            primaryAction: req.body.primaryAction,
+            targetPlatforms: Array.isArray(req.body.targetPlatforms)
+                ? req.body.targetPlatforms.map(String)
+                : [],
+            successCriteria: Array.isArray(req.body.successCriteria)
+                ? req.body.successCriteria.map(String)
+                : [],
+            steps: Array.isArray(req.body.steps)
+                ? req.body.steps
+                : [],
+        };
+        const saved = store.add(payload);
+        res.status(201).json(saved);
+    });
+    app.get('/api/bootstraps/:id', (req, res) => {
+        const record = store.find(req.params.id);
+        if (!record) {
+            return res.status(404).json({ error: 'bootstrap not found' });
+        }
+        res.json(record);
+    });
+    app.use((_req, res) => {
+        res.status(404).json({ error: 'not found' });
+    });
+    app.use((err, _req, res, next) => {
+        // eslint-disable-next-line no-console
+        console.error('internal error', err);
+        res.status(500).json({ error: 'internal server error' });
+        next(err);
+    });
+    return { app, store };
+}

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+import BootstrapStore from './store';
+import createApp from './app';
+import startServer from './server';
+export { BootstrapStore, createApp, startServer };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,SAAS,CAAC;AACrC,OAAO,SAAS,MAAM,OAAO,CAAC;AAC9B,OAAO,WAAW,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = exports.createApp = exports.BootstrapStore = void 0;
+const store_1 = __importDefault(require("./store"));
+exports.BootstrapStore = store_1.default;
+const app_1 = __importDefault(require("./app"));
+exports.createApp = app_1.default;
+const server_1 = __importDefault(require("./server"));
+exports.startServer = server_1.default;

package/dist/src/server.d.ts

@@ -0,0 +1,12 @@
+import type { Express } from 'express';
+import type { Server } from 'http';
+export interface StartServerOptions {
+    port?: number;
+    onStart?: (message: string, port: number) => void;
+}
+export interface StartServerResult {
+    app: Express;
+    server: Server;
+}
+export default function startServer({ port, onStart, }?: StartServerOptions): StartServerResult;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,IAAI,EACJ,OAAO,GACR,GAAE,kBAAuB,GAAG,iBAAiB,CA0B7C"}

package/dist/src/server.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = startServer;
+const app_1 = __importDefault(require("./app"));
+function startServer({ port, onStart, } = {}) {
+    const defaultPort = Number(process.env.PORT) || 4000;
+    const resolvedPort = port ?? defaultPort;
+    const { app } = (0, app_1.default)();
+    const server = app.listen(resolvedPort, () => {
+        const message = `Project Bootstrap MCP listening on port ${resolvedPort}`;
+        if (typeof onStart === 'function') {
+            onStart(message, resolvedPort);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log(message);
+        }
+    });
+    const graceful = () => {
+        server.close(() => {
+            // eslint-disable-next-line no-console
+            console.log('Project Bootstrap MCP shutting down');
+            process.exit(0);
+        });
+    };
+    process.on('SIGINT', graceful);
+    process.on('SIGTERM', graceful);
+    return { app, server };
+}

package/dist/src/store.d.ts

@@ -0,0 +1,9 @@
+import type { BootstrapPayload, BootstrapRecord } from './types';
+export default class BootstrapStore {
+    private readonly items;
+    private counter;
+    list(): BootstrapRecord[];
+    add(payload: BootstrapPayload): BootstrapRecord;
+    find(id: string): BootstrapRecord | null;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,OAAO,CAAK;IAEb,IAAI,IAAI,eAAe,EAAE;IAIzB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe;IAW/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;CAGhD"}

package/dist/src/store.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class BootstrapStore {
+    constructor() {
+        this.items = new Map();
+        this.counter = 1;
+    }
+    list() {
+        return Array.from(this.items.values());
+    }
+    add(payload) {
+        const id = String(this.counter++);
+        const record = {
+            id,
+            createdAt: new Date().toISOString(),
+            ...payload,
+        };
+        this.items.set(id, record);
+        return record;
+    }
+    find(id) {
+        return this.items.get(id) ?? null;
+    }
+}
+exports.default = BootstrapStore;

package/dist/src/types.d.ts

@@ -0,0 +1,17 @@
+export interface BootstrapStep {
+    title: string;
+    detail: string;
+}
+export interface BootstrapPayload {
+    name: string;
+    description: string;
+    primaryAction: string;
+    targetPlatforms?: string[];
+    successCriteria?: string[];
+    steps: BootstrapStep[];
+}
+export interface BootstrapRecord extends BootstrapPayload {
+    id: string;
+    createdAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/validators.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateBootstrapPayload(payload: unknown): ValidationResult;
+//# sourceMappingURL=validators.d.ts.map

package/dist/src/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/validators.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAmC3E"}

package/dist/src/validators.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBootstrapPayload = validateBootstrapPayload;
+function validateBootstrapPayload(payload) {
+    const errors = [];
+    if (!payload || typeof payload !== 'object') {
+        errors.push('payload must be an object');
+        return { valid: false, errors };
+    }
+    const typedPayload = payload;
+    const { name, description, primaryAction, steps } = typedPayload;
+    if (!name || typeof name !== 'string') {
+        errors.push('name is required and must be a string');
+    }
+    if (!description || typeof description !== 'string') {
+        errors.push('description is required and must be a string');
+    }
+    if (!primaryAction || typeof primaryAction !== 'string') {
+        errors.push('primaryAction is required and must be a string');
+    }
+    if (!Array.isArray(steps) || steps.length === 0) {
+        errors.push('steps must be a non-empty array');
+    }
+    else {
+        steps.forEach((step, index) => {
+            const currentStep = step;
+            if (!currentStep || typeof currentStep.title !== 'string') {
+                errors.push(`steps[${index}].title is required`);
+            }
+            if (!currentStep || typeof currentStep.detail !== 'string') {
+                errors.push(`steps[${index}].detail is required`);
+            }
+        });
+    }
+    return { valid: errors.length === 0, errors };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tac0de/project-bootstrap-mcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Project Bootstrap MCP API tooling for launching MCP bootstrap definitions and documentation.",
   "main": "dist/index.js",
   "bin": {

package/src/server.js

@@ -1,29 +0,0 @@
-const createApp = require('./app');
-
-function startServer({ port = process.env.PORT || 4000, onStart } = {}) {
-  const { app } = createApp();
-  const server = app.listen(port, () => {
-    const message = `Project Bootstrap MCP listening on port ${port}`;
-    if (typeof onStart === 'function') {
-      onStart(message, port);
-    } else {
-      // eslint-disable-next-line no-console
-      console.log(message);
-    }
-  });
-
-  const graceful = () => {
-    server.close(() => {
-      // eslint-disable-next-line no-console
-      console.log('Project Bootstrap MCP shutting down');
-      process.exit(0);
-    });
-  };
-
-  process.on('SIGINT', graceful);
-  process.on('SIGTERM', graceful);
-
-  return { app, server };
-}
-
-module.exports = startServer;