the-grid-cc 1.7.1 → 1.7.3

package/tools/grid-viz/grid-viz.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+// ANSI color helpers
+const colors = {
+  title: chalk.bold.cyan,
+  heading: chalk.bold.yellow,
+  label: chalk.gray,
+  value: chalk.white,
+  success: chalk.green,
+  warning: chalk.yellow,
+  error: chalk.red,
+  muted: chalk.dim,
+  highlight: chalk.bold.magenta,
+  progress: chalk.blue,
+};
+
+// Find .grid directory
+function findGridDir() {
+  let currentDir = process.cwd();
+  while (currentDir !== '/') {
+    const gridPath = path.join(currentDir, '.grid');
+    if (fs.existsSync(gridPath) && fs.statSync(gridPath).isDirectory()) {
+      return gridPath;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  return null;
+}
+
+// Parse markdown file for key-value pairs
+function parseMarkdown(content) {
+  const lines = content.split('\n');
+  const data = {};
+  let currentSection = null;
+
+  for (const line of lines) {
+    // Detect headings
+    if (line.startsWith('## ')) {
+      currentSection = line.substring(3).trim();
+      data[currentSection] = [];
+    } else if (line.startsWith('### ')) {
+      const subheading = line.substring(4).trim();
+      if (currentSection) {
+        data[currentSection].push({ type: 'subheading', value: subheading });
+      }
+    } else if (line.trim() && currentSection) {
+      data[currentSection].push({ type: 'line', value: line });
+    }
+  }
+
+  return data;
+}
+
+// Extract progress information from STATE.md
+function parseState(content) {
+  const state = {
+    cluster: null,
+    status: null,
+    energy: null,
+    phase: null,
+    block: null,
+    progress: null,
+    lastActivity: null,
+  };
+
+  const lines = content.split('\n');
+  for (const line of lines) {
+    if (line.startsWith('## CLUSTER:')) {
+      state.cluster = line.substring(11).trim();
+    } else if (line.startsWith('**Status:**')) {
+      state.status = line.substring(11).trim();
+    } else if (line.startsWith('**Energy:**')) {
+      state.energy = line.substring(11).trim();
+    } else if (line.includes('Phase:')) {
+      state.phase = line.split('Phase:')[1].trim();
+    } else if (line.includes('Block:')) {
+      state.block = line.split('Block:')[1].trim();
+    } else if (line.includes('Progress:')) {
+      state.progress = line.split('Progress:')[1].trim();
+    } else if (line.includes('Last activity:')) {
+      state.lastActivity = line.split('Last activity:')[1].trim();
+    }
+  }
+
+  return state;
+}
+
+// Parse scratchpad for recent entries
+function parseScratchpad(content) {
+  const entries = [];
+  const sections = content.split('###').filter(s => s.trim());
+
+  for (const section of sections) {
+    const lines = section.trim().split('\n');
+    if (lines.length > 0) {
+      const header = lines[0].trim();
+      const body = lines.slice(1).join('\n').trim();
+      entries.push({ header, body });
+    }
+  }
+
+  return entries.slice(-5); // Last 5 entries
+}
+
+// Parse learnings for count
+function parseLearnings(content) {
+  const lines = content.split('\n');
+  let count = 0;
+
+  for (const line of lines) {
+    if (line.trim().startsWith('-') || line.trim().startsWith('*')) {
+      count++;
+    }
+  }
+
+  return count;
+}
+
+// Render progress bar
+function renderProgressBar(percentage, width = 40) {
+  const filled = Math.round((percentage / 100) * width);
+  const empty = width - filled;
+  const bar = '█'.repeat(filled) + '░'.repeat(empty);
+  return `${colors.progress(bar)} ${colors.value(percentage + '%')}`;
+}
+
+// Main visualization
+function visualize() {
+  console.log('\n' + colors.title('═'.repeat(80)));
+  console.log(colors.title('  THE GRID - State Visualization'));
+  console.log(colors.title('═'.repeat(80)) + '\n');
+
+  const gridDir = findGridDir();
+
+  if (!gridDir) {
+    console.log(colors.error('✗ No .grid directory found in current path or parent directories\n'));
+    console.log(colors.muted('  Run this command from within a Grid-initialized project\n'));
+    process.exit(1);
+  }
+
+  console.log(colors.label('Grid directory: ') + colors.muted(gridDir) + '\n');
+
+  // Read STATE.md
+  const statePath = path.join(gridDir, 'STATE.md');
+  if (!fs.existsSync(statePath)) {
+    console.log(colors.warning('⚠ STATE.md not found\n'));
+  } else {
+    const stateContent = fs.readFileSync(statePath, 'utf8');
+    const state = parseState(stateContent);
+
+    console.log(colors.heading('CLUSTER STATUS'));
+    console.log(colors.label('  Name:     ') + colors.value(state.cluster || 'Unknown'));
+    console.log(colors.label('  Status:   ') + (state.status === 'COMPLETE' ? colors.success(state.status) : colors.warning(state.status || 'Unknown')));
+    console.log(colors.label('  Energy:   ') + colors.highlight(state.energy || 'N/A'));
+
+    if (state.phase) {
+      console.log(colors.label('  Phase:    ') + colors.value(state.phase));
+    }
+    if (state.block) {
+      console.log(colors.label('  Block:    ') + colors.value(state.block));
+    }
+
+    // Progress bar
+    if (state.progress) {
+      const progressMatch = state.progress.match(/(\d+)%/);
+      if (progressMatch) {
+        const percentage = parseInt(progressMatch[1]);
+        console.log(colors.label('  Progress: ') + renderProgressBar(percentage));
+      }
+    }
+
+    if (state.lastActivity) {
+      console.log(colors.label('  Last:     ') + colors.muted(state.lastActivity));
+    }
+
+    console.log('');
+  }
+
+  // Read SCRATCHPAD.md
+  const scratchpadPath = path.join(gridDir, 'SCRATCHPAD.md');
+  if (fs.existsSync(scratchpadPath)) {
+    const scratchpadContent = fs.readFileSync(scratchpadPath, 'utf8');
+    const entries = parseScratchpad(scratchpadContent);
+
+    if (entries.length > 0) {
+      console.log(colors.heading('RECENT SCRATCHPAD ENTRIES'));
+      entries.forEach((entry, index) => {
+        console.log(colors.label(`  [${entries.length - index}] `) + colors.value(entry.header));
+        if (entry.body) {
+          const preview = entry.body.substring(0, 60);
+          console.log(colors.muted(`      ${preview}${entry.body.length > 60 ? '...' : ''}`));
+        }
+      });
+      console.log('');
+    }
+  }
+
+  // Read LEARNINGS.md
+  const learningsPath = path.join(gridDir, 'LEARNINGS.md');
+  if (fs.existsSync(learningsPath)) {
+    const learningsContent = fs.readFileSync(learningsPath, 'utf8');
+    const learningCount = parseLearnings(learningsContent);
+
+    console.log(colors.heading('WARMTH'));
+    console.log(colors.label('  Learnings: ') + colors.highlight(learningCount + ' patterns captured'));
+    console.log('');
+  }
+
+  // Read BLOCKERS.md
+  const blockersPath = path.join(gridDir, 'BLOCKERS.md');
+  if (fs.existsSync(blockersPath)) {
+    const blockersContent = fs.readFileSync(blockersPath, 'utf8');
+    const blockerLines = blockersContent.split('\n').filter(l => l.trim().startsWith('-') || l.trim().startsWith('*'));
+
+    if (blockerLines.length > 0) {
+      console.log(colors.heading('ACTIVE BLOCKERS'));
+      blockerLines.slice(0, 5).forEach(blocker => {
+        console.log(colors.error('  ✗ ') + colors.value(blocker.replace(/^[-*]\s*/, '')));
+      });
+      console.log('');
+    }
+  }
+
+  // Read DECISIONS.md
+  const decisionsPath = path.join(gridDir, 'DECISIONS.md');
+  if (fs.existsSync(decisionsPath)) {
+    const decisionsContent = fs.readFileSync(decisionsPath, 'utf8');
+    const decisionLines = decisionsContent.split('\n').filter(l => l.trim().startsWith('-') || l.trim().startsWith('*'));
+
+    if (decisionLines.length > 0) {
+      console.log(colors.heading('PENDING DECISIONS'));
+      decisionLines.slice(0, 3).forEach(decision => {
+        console.log(colors.warning('  ? ') + colors.value(decision.replace(/^[-*]\s*/, '')));
+      });
+      console.log('');
+    }
+  }
+
+  console.log(colors.title('═'.repeat(80)));
+  console.log(colors.muted('  End of Line.\n'));
+}
+
+// Run
+visualize();

package/tools/grid-viz/node_modules/.package-lock.json

@@ -0,0 +1,78 @@
+{
+  "name": "grid-viz",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "license": "MIT"
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    }
+  }
+}

package/tools/grid-viz/node_modules/ansi-styles/index.d.ts

@@ -0,0 +1,345 @@
+declare type CSSColor =
+	| 'aliceblue'
+	| 'antiquewhite'
+	| 'aqua'
+	| 'aquamarine'
+	| 'azure'
+	| 'beige'
+	| 'bisque'
+	| 'black'
+	| 'blanchedalmond'
+	| 'blue'
+	| 'blueviolet'
+	| 'brown'
+	| 'burlywood'
+	| 'cadetblue'
+	| 'chartreuse'
+	| 'chocolate'
+	| 'coral'
+	| 'cornflowerblue'
+	| 'cornsilk'
+	| 'crimson'
+	| 'cyan'
+	| 'darkblue'
+	| 'darkcyan'
+	| 'darkgoldenrod'
+	| 'darkgray'
+	| 'darkgreen'
+	| 'darkgrey'
+	| 'darkkhaki'
+	| 'darkmagenta'
+	| 'darkolivegreen'
+	| 'darkorange'
+	| 'darkorchid'
+	| 'darkred'
+	| 'darksalmon'
+	| 'darkseagreen'
+	| 'darkslateblue'
+	| 'darkslategray'
+	| 'darkslategrey'
+	| 'darkturquoise'
+	| 'darkviolet'
+	| 'deeppink'
+	| 'deepskyblue'
+	| 'dimgray'
+	| 'dimgrey'
+	| 'dodgerblue'
+	| 'firebrick'
+	| 'floralwhite'
+	| 'forestgreen'
+	| 'fuchsia'
+	| 'gainsboro'
+	| 'ghostwhite'
+	| 'gold'
+	| 'goldenrod'
+	| 'gray'
+	| 'green'
+	| 'greenyellow'
+	| 'grey'
+	| 'honeydew'
+	| 'hotpink'
+	| 'indianred'
+	| 'indigo'
+	| 'ivory'
+	| 'khaki'
+	| 'lavender'
+	| 'lavenderblush'
+	| 'lawngreen'
+	| 'lemonchiffon'
+	| 'lightblue'
+	| 'lightcoral'
+	| 'lightcyan'
+	| 'lightgoldenrodyellow'
+	| 'lightgray'
+	| 'lightgreen'
+	| 'lightgrey'
+	| 'lightpink'
+	| 'lightsalmon'
+	| 'lightseagreen'
+	| 'lightskyblue'
+	| 'lightslategray'
+	| 'lightslategrey'
+	| 'lightsteelblue'
+	| 'lightyellow'
+	| 'lime'
+	| 'limegreen'
+	| 'linen'
+	| 'magenta'
+	| 'maroon'
+	| 'mediumaquamarine'
+	| 'mediumblue'
+	| 'mediumorchid'
+	| 'mediumpurple'
+	| 'mediumseagreen'
+	| 'mediumslateblue'
+	| 'mediumspringgreen'
+	| 'mediumturquoise'
+	| 'mediumvioletred'
+	| 'midnightblue'
+	| 'mintcream'
+	| 'mistyrose'
+	| 'moccasin'
+	| 'navajowhite'
+	| 'navy'
+	| 'oldlace'
+	| 'olive'
+	| 'olivedrab'
+	| 'orange'
+	| 'orangered'
+	| 'orchid'
+	| 'palegoldenrod'
+	| 'palegreen'
+	| 'paleturquoise'
+	| 'palevioletred'
+	| 'papayawhip'
+	| 'peachpuff'
+	| 'peru'
+	| 'pink'
+	| 'plum'
+	| 'powderblue'
+	| 'purple'
+	| 'rebeccapurple'
+	| 'red'
+	| 'rosybrown'
+	| 'royalblue'
+	| 'saddlebrown'
+	| 'salmon'
+	| 'sandybrown'
+	| 'seagreen'
+	| 'seashell'
+	| 'sienna'
+	| 'silver'
+	| 'skyblue'
+	| 'slateblue'
+	| 'slategray'
+	| 'slategrey'
+	| 'snow'
+	| 'springgreen'
+	| 'steelblue'
+	| 'tan'
+	| 'teal'
+	| 'thistle'
+	| 'tomato'
+	| 'turquoise'
+	| 'violet'
+	| 'wheat'
+	| 'white'
+	| 'whitesmoke'
+	| 'yellow'
+	| 'yellowgreen';
+
+declare namespace ansiStyles {
+	interface ColorConvert {
+		/**
+		The RGB color space.
+
+		@param red - (`0`-`255`)
+		@param green - (`0`-`255`)
+		@param blue - (`0`-`255`)
+		*/
+		rgb(red: number, green: number, blue: number): string;
+
+		/**
+		The RGB HEX color space.
+
+		@param hex - A hexadecimal string containing RGB data.
+		*/
+		hex(hex: string): string;
+
+		/**
+		@param keyword - A CSS color name.
+		*/
+		keyword(keyword: CSSColor): string;
+
+		/**
+		The HSL color space.
+
+		@param hue - (`0`-`360`)
+		@param saturation - (`0`-`100`)
+		@param lightness - (`0`-`100`)
+		*/
+		hsl(hue: number, saturation: number, lightness: number): string;
+
+		/**
+		The HSV color space.
+
+		@param hue - (`0`-`360`)
+		@param saturation - (`0`-`100`)
+		@param value - (`0`-`100`)
+		*/
+		hsv(hue: number, saturation: number, value: number): string;
+
+		/**
+		The HSV color space.
+
+		@param hue - (`0`-`360`)
+		@param whiteness - (`0`-`100`)
+		@param blackness - (`0`-`100`)
+		*/
+		hwb(hue: number, whiteness: number, blackness: number): string;
+
+		/**
+		Use a [4-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#3/4-bit) to set text color.
+		*/
+		ansi(ansi: number): string;
+
+		/**
+		Use an [8-bit unsigned number](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) to set text color.
+		*/
+		ansi256(ansi: number): string;
+	}
+
+	interface CSPair {
+		/**
+		The ANSI terminal control sequence for starting this style.
+		*/
+		readonly open: string;
+
+		/**
+		The ANSI terminal control sequence for ending this style.
+		*/
+		readonly close: string;
+	}
+
+	interface ColorBase {
+		readonly ansi: ColorConvert;
+		readonly ansi256: ColorConvert;
+		readonly ansi16m: ColorConvert;
+
+		/**
+		The ANSI terminal control sequence for ending this color.
+		*/
+		readonly close: string;
+	}
+
+	interface Modifier {
+		/**
+		Resets the current color chain.
+		*/
+		readonly reset: CSPair;
+
+		/**
+		Make text bold.
+		*/
+		readonly bold: CSPair;
+
+		/**
+		Emitting only a small amount of light.
+		*/
+		readonly dim: CSPair;
+
+		/**
+		Make text italic. (Not widely supported)
+		*/
+		readonly italic: CSPair;
+
+		/**
+		Make text underline. (Not widely supported)
+		*/
+		readonly underline: CSPair;
+
+		/**
+		Inverse background and foreground colors.
+		*/
+		readonly inverse: CSPair;
+
+		/**
+		Prints the text, but makes it invisible.
+		*/
+		readonly hidden: CSPair;
+
+		/**
+		Puts a horizontal line through the center of the text. (Not widely supported)
+		*/
+		readonly strikethrough: CSPair;
+	}
+
+	interface ForegroundColor {
+		readonly black: CSPair;
+		readonly red: CSPair;
+		readonly green: CSPair;
+		readonly yellow: CSPair;
+		readonly blue: CSPair;
+		readonly cyan: CSPair;
+		readonly magenta: CSPair;
+		readonly white: CSPair;
+
+		/**
+		Alias for `blackBright`.
+		*/
+		readonly gray: CSPair;
+
+		/**
+		Alias for `blackBright`.
+		*/
+		readonly grey: CSPair;
+
+		readonly blackBright: CSPair;
+		readonly redBright: CSPair;
+		readonly greenBright: CSPair;
+		readonly yellowBright: CSPair;
+		readonly blueBright: CSPair;
+		readonly cyanBright: CSPair;
+		readonly magentaBright: CSPair;
+		readonly whiteBright: CSPair;
+	}
+
+	interface BackgroundColor {
+		readonly bgBlack: CSPair;
+		readonly bgRed: CSPair;
+		readonly bgGreen: CSPair;
+		readonly bgYellow: CSPair;
+		readonly bgBlue: CSPair;
+		readonly bgCyan: CSPair;
+		readonly bgMagenta: CSPair;
+		readonly bgWhite: CSPair;
+
+		/**
+		Alias for `bgBlackBright`.
+		*/
+		readonly bgGray: CSPair;
+
+		/**
+		Alias for `bgBlackBright`.
+		*/
+		readonly bgGrey: CSPair;
+
+		readonly bgBlackBright: CSPair;
+		readonly bgRedBright: CSPair;
+		readonly bgGreenBright: CSPair;
+		readonly bgYellowBright: CSPair;
+		readonly bgBlueBright: CSPair;
+		readonly bgCyanBright: CSPair;
+		readonly bgMagentaBright: CSPair;
+		readonly bgWhiteBright: CSPair;
+	}
+}
+
+declare const ansiStyles: {
+	readonly modifier: ansiStyles.Modifier;
+	readonly color: ansiStyles.ForegroundColor & ansiStyles.ColorBase;
+	readonly bgColor: ansiStyles.BackgroundColor & ansiStyles.ColorBase;
+	readonly codes: ReadonlyMap<number, number>;
+} & ansiStyles.BackgroundColor & ansiStyles.ForegroundColor & ansiStyles.Modifier;
+
+export = ansiStyles;