@polymorphism-tech/morph-spec 4.7.0 → 4.7.2

package/.morph/framework/hooks/shared/state-reader.js

@@ -0,0 +1,138 @@
+/**
+ * Shared read-only state accessor for Claude Code hooks.
+ *
+ * Wraps state.json reads with fail-open semantics:
+ * - Returns null instead of throwing on missing/corrupt state
+ * - Never writes to state.json (read-only)
+ * - Uses synchronous reads for <100ms performance
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+const STATE_FILE = '.morph/state.json';
+
+/**
+ * Load state.json from the project root.
+ * Fail-open: returns null if file missing or corrupt.
+ * @param {string} [projectPath] - Project root (defaults to cwd)
+ * @returns {Object|null} State object or null
+ */
+export function loadState(projectPath) {
+  try {
+    const statePath = join(projectPath || process.cwd(), STATE_FILE);
+    if (!existsSync(statePath)) return null;
+    return JSON.parse(readFileSync(statePath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if state.json exists.
+ * @param {string} [projectPath]
+ * @returns {boolean}
+ */
+export function stateExists(projectPath) {
+  return existsSync(join(projectPath || process.cwd(), STATE_FILE));
+}
+
+/**
+ * Get the active feature (most recently updated in_progress feature).
+ * @param {string} [projectPath]
+ * @returns {{ name: string, feature: Object }|null}
+ */
+export function getActiveFeature(projectPath) {
+  const state = loadState(projectPath);
+  if (!state?.features) return null;
+
+  let active = null;
+  let latestUpdate = '';
+
+  for (const [name, feature] of Object.entries(state.features)) {
+    if (feature.status === 'in_progress' || feature.status === 'draft') {
+      const updated = feature.updatedAt || feature.createdAt || '';
+      if (updated >= latestUpdate) {
+        latestUpdate = updated;
+        active = { name, feature };
+      }
+    }
+  }
+
+  return active;
+}
+
+/**
+ * Get a specific feature by name.
+ * @param {string} featureName
+ * @param {string} [projectPath]
+ * @returns {Object|null}
+ */
+export function getFeature(featureName, projectPath) {
+  const state = loadState(projectPath);
+  return state?.features?.[featureName] || null;
+}
+
+/**
+ * Get the current phase of a feature.
+ * @param {string} featureName
+ * @param {string} [projectPath]
+ * @returns {string|null}
+ */
+export function getFeaturePhase(featureName, projectPath) {
+  const feature = getFeature(featureName, projectPath);
+  return feature?.phase || null;
+}
+
+/**
+ * Get approval status for a gate.
+ * @param {string} featureName
+ * @param {string} gate - 'proposal'|'uiux'|'design'|'tasks'
+ * @param {string} [projectPath]
+ * @returns {boolean}
+ */
+export function isGateApproved(featureName, gate, projectPath) {
+  const feature = getFeature(featureName, projectPath);
+  return feature?.approvalGates?.[gate]?.approved === true;
+}
+
+/**
+ * Get all pending approval gates for a feature.
+ * @param {string} featureName
+ * @param {string} [projectPath]
+ * @returns {string[]} List of gate names that are not yet approved
+ */
+export function getPendingGates(featureName, projectPath) {
+  const feature = getFeature(featureName, projectPath);
+  if (!feature?.approvalGates) return [];
+
+  return Object.entries(feature.approvalGates)
+    .filter(([, gate]) => !gate.approved)
+    .map(([name]) => name);
+}
+
+/**
+ * Get feature outputs status.
+ * @param {string} featureName
+ * @param {string} [projectPath]
+ * @returns {Object|null} outputs map or null
+ */
+export function getOutputs(featureName, projectPath) {
+  const feature = getFeature(featureName, projectPath);
+  return feature?.outputs || null;
+}
+
+/**
+ * Get uncompleted required outputs for current phase.
+ * @param {string} featureName
+ * @param {string} [projectPath]
+ * @returns {Array<{type: string, path: string}>}
+ */
+export function getMissingOutputs(featureName, projectPath) {
+  const feature = getFeature(featureName, projectPath);
+  if (!feature?.outputs) return [];
+
+  return Object.entries(feature.outputs)
+    .filter(([, output]) => !output.created)
+    .map(([type, output]) => ({ type, path: output.path }));
+}

package/.morph/framework/hooks/shared/stdin-reader.js

@@ -0,0 +1,26 @@
+/**
+ * Shared stdin reader for Claude Code hooks.
+ *
+ * Reads JSON payload from stdin (provided by Claude Code to hooks).
+ * Returns parsed object or null on failure.
+ */
+
+/**
+ * Read and parse JSON from stdin
+ * @returns {Promise<Object|null>} Parsed JSON or null
+ */
+export function readStdin() {
+  return new Promise((resolve) => {
+    let input = '';
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { input += chunk; });
+    process.stdin.on('end', () => {
+      try {
+        resolve(JSON.parse(input || '{}'));
+      } catch {
+        resolve(null);
+      }
+    });
+    process.stdin.on('error', () => resolve(null));
+  });
+}