@tmddev/tmd 0.1.0

package/dist/utils/templates.js

@@ -0,0 +1,143 @@
+/**
+ * Template generators for PDCA phase documents
+ * All templates are in English as per specification
+ */
+export const planTemplate = `# Plan: {{description}}
+
+## Why
+<!-- Define the problem or improvement opportunity -->
+<!-- What issue are we solving? What opportunity are we pursuing? -->
+
+## Goals
+<!-- SMART Goals: Specific, Measurable, Achievable, Relevant, Time-bound -->
+<!-- Example: "Reduce image load time by 50% within 2 weeks" -->
+- [ ] Goal 1:
+- [ ] Goal 2:
+
+## What Changes
+<!-- Specific changes to be made -->
+<!-- List concrete deliverables and modifications -->
+-
+
+## Impact
+<!-- Affected systems, files, processes, or stakeholders -->
+- Affected areas:
+- Dependencies:
+- Risks:
+
+## Tasks
+<!-- Implementation steps as checklist -->
+<!-- 
+  Task Size Guidelines: Ten seconds to Ten minutes Task Markdown Driven Development!
+  Tasks should be atomic and completable in 10 seconds to 10 minutes (pee-break sized).
+  - Each task should be a single, focused action
+  - Avoid compound tasks (tasks with "and" or multiple actions)
+  - Break down large tasks into smaller atomic tasks
+  
+  Examples of good atomic tasks:
+  - "Add import statement"
+  - "Update function signature"
+  - "Create test file"
+  - "Fix typo in documentation"
+  
+  Examples of tasks to break down:
+  - "Implement authentication and authorization" → Break into: "Add auth middleware", "Create login endpoint", "Add password validation"
+  - "Create API and update frontend" → Break into: "Create API endpoint", "Update frontend component", "Add API integration"
+-->
+- [ ] 1.
+- [ ] 2.
+- [ ] 3.
+
+## OpenSpec Change
+<!-- Link to OpenSpec change proposal if applicable -->
+`;
+export const executionTemplate = `# Execution: {{taskId}}
+
+## Actions Taken
+<!-- Document actions performed -->
+
+## Data Collected
+<!-- Record data collected during execution -->
+
+## Observations
+<!-- Note any observations or insights -->
+
+## Issues Encountered
+<!-- Document any problems or blockers -->
+
+## Time Tracking
+<!-- Track time spent if applicable -->
+`;
+export const evaluationTemplate = `# Evaluation: {{taskId}}
+
+## Results Summary
+<!-- Summarize execution results -->
+
+## Comparison with Plan
+<!-- Compare actual results with planned objectives -->
+
+| Objective | Planned | Actual | Status |
+|-----------|---------|--------|--------|
+|           |         |        |        |
+
+## Deviations Identified
+<!-- List any deviations from the plan -->
+
+## Root Cause Analysis
+<!-- Analyze causes of deviations -->
+
+## Lessons Learned
+<!-- Document insights and learnings -->
+`;
+export const improvementTemplate = `# Improvement Actions: {{taskId}}
+
+## Corrective Actions
+<!-- Actions to address identified issues -->
+
+## Preventive Measures
+<!-- Measures to prevent similar issues in future -->
+
+## Standardization Opportunities
+<!-- Practices that can be standardized -->
+
+## Next Cycle Planning
+<!-- Plan for next PDCA iteration -->
+`;
+export const resourcesTemplate = `# Resources: {{description}}
+
+## People / Roles
+<!-- Who is needed for this task? -->
+-
+
+## Tools & Systems
+<!-- What tools, systems, or infrastructure is required? -->
+-
+
+## Data Requirements
+<!-- What data or information is needed? -->
+-
+
+## Time Estimate
+<!-- Estimated effort and timeline -->
+- Effort:
+- Timeline:
+`;
+export const standardizationTemplate = `# Standardization: {{taskId}}
+
+## Successful Practices
+<!-- Document practices that worked well -->
+
+## Reusable Patterns
+<!-- Patterns that can be reused -->
+
+## Standard Operating Procedures
+<!-- Document SOPs if applicable -->
+`;
+export function renderTemplate(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replace(new RegExp(`{{${key}}}`, 'g'), value);
+    }
+    return result;
+}
+//# sourceMappingURL=templates.js.map

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@tmddev/tmd",
+  "version": "0.1.0",
+  "description": "Task Markdown Driven - A lightweight PDCA cycle management framework integrated with OpenSpec",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "tmd": "./bin/tmd.js",
+    "tmdp": "./bin/tmd.js",
+    "tmdd": "./bin/tmd.js",
+    "tmdc": "./bin/tmd.js",
+    "tmda": "./bin/tmd.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts/postinstall.js",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__",
+    "!dist/**/*.map"
+  ],
+  "scripts": {
+    "lint": "eslint src/",
+    "build": "tsx build.ts",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/tmd.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run build",
+    "postinstall": "node scripts/postinstall.js",
+    "check:pack-version": "node scripts/pack-version-check.mjs",
+    "release": "pnpm run release:ci",
+    "release:ci": "pnpm run check:pack-version",
+    "changeset": "changeset"
+  },
+  "keywords": [
+    "pdca",
+    "openspec",
+    "documentation",
+    "management",
+    "cli",
+    "task-management",
+    "markdown",
+    "workflow"
+  ],
+  "homepage": "https://tmdd.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sdd330/tmd.git"
+  },
+  "author": "TMD Contributors",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^13.1.0",
+    "js-yaml": "^4.1.0",
+    "chalk": "^5.4.1"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.27.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.12.0",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.39.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for TMD
+ *
+ * This script runs automatically after npm install unless:
+ * - CI=true environment variable is set
+ * - TMD_NO_POSTINSTALL=1 environment variable is set
+ * - dist/ directory doesn't exist (dev setup scenario)
+ *
+ * The script never fails npm install - all errors are caught and handled gracefully.
+ */
+
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Check if we should skip installation
+ */
+function shouldSkipInstallation() {
+  // Skip in CI environments
+  if (process.env.CI === 'true' || process.env.CI === '1') {
+    return { skip: true, reason: 'CI environment detected' };
+  }
+
+  // Skip if user opted out
+  if (process.env.TMD_NO_POSTINSTALL === '1') {
+    return { skip: true, reason: 'TMD_NO_POSTINSTALL=1 set' };
+  }
+
+  return { skip: false };
+}
+
+/**
+ * Check if dist/ directory exists
+ */
+async function distExists() {
+  const distPath = path.join(__dirname, '..', 'dist');
+  try {
+    const stat = await fs.stat(distPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Main function
+ */
+async function main() {
+  try {
+    // Check if we should skip
+    const skipCheck = shouldSkipInstallation();
+    if (skipCheck.skip) {
+      // Silent skip - no output
+      return;
+    }
+
+    // Check if dist/ exists (skip silently if not - expected during dev setup)
+    if (!(await distExists())) {
+      return;
+    }
+
+    // Placeholder for future post-installation tasks
+    // Examples:
+    // - Initialize default configuration
+    // - Set up example templates
+    // - Verify installation integrity
+    
+    // For now, just verify the CLI is available
+    const binPath = path.join(__dirname, '..', 'bin', 'tmd.js');
+    try {
+      await fs.access(binPath);
+      // CLI is available - installation successful
+    } catch {
+      // CLI not found - this is OK in dev scenarios
+    }
+  } catch (error) {
+    // Fail gracefully - never break npm install
+    // Silent failure
+  }
+}
+
+// Run main and handle any unhandled errors
+main().catch(() => {
+  // Silent failure - never break npm install
+  process.exit(0);
+});