@grainulation/orchard 1.0.0

package/lib/sync.js

@@ -0,0 +1,100 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { readSprintState } = require('./tracker.js');
+
+/**
+ * Sync all sprint states from their directories into orchard.json.
+ * Updates status based on what's actually on disk.
+ */
+function syncAll(config, root) {
+  const sprints = config.sprints || [];
+  let updated = 0;
+
+  console.log('');
+  console.log('  Syncing sprint states...');
+  console.log('');
+
+  for (const sprint of sprints) {
+    const state = readSprintState(sprint.path, root);
+
+    if (!state.exists) {
+      console.log(`  [!] ${path.basename(sprint.path)}: directory not found`);
+      continue;
+    }
+
+    const oldStatus = sprint.status;
+    const inferred = inferStatus(sprint, state);
+
+    if (oldStatus !== inferred) {
+      sprint.status = inferred;
+      updated++;
+      console.log(`  [~] ${path.basename(sprint.path)}: ${oldStatus || 'unknown'} -> ${inferred}`);
+    } else {
+      console.log(`  [=] ${path.basename(sprint.path)}: ${inferred} (${state.claimsCount} claims)`);
+    }
+  }
+
+  if (updated > 0) {
+    const configPath = path.join(root, 'orchard.json');
+    const tmp = configPath + '.tmp.' + process.pid;
+    fs.writeFileSync(tmp, JSON.stringify(config, null, 2) + '\n');
+    fs.renameSync(tmp, configPath);
+    console.log('');
+    console.log(`  Updated ${updated} sprint(s) in orchard.json.`);
+  } else {
+    console.log('');
+    console.log('  All sprints up to date.');
+  }
+
+  console.log('');
+}
+
+/**
+ * Infer sprint status from disk state + config.
+ */
+function inferStatus(sprint, state) {
+  // If manually set to done, keep it
+  if (sprint.status === 'done') return 'done';
+
+  // If manually blocked, keep it
+  if (sprint.status === 'blocked') return 'blocked';
+
+  if (!state.exists) return 'not-found';
+  if (state.claimsCount === 0) return 'not-started';
+  if (state.hasCompilation) return 'compiled';
+  return 'active';
+}
+
+/**
+ * Check which sprints are ready to start (all dependencies met).
+ */
+function findReady(config, root) {
+  const sprints = config.sprints || [];
+  const statuses = new Map();
+
+  for (const s of sprints) {
+    statuses.set(s.path, s.status || 'unknown');
+  }
+
+  const ready = [];
+  for (const s of sprints) {
+    if (s.status === 'done' || s.status === 'active') continue;
+
+    const deps = s.depends_on || [];
+    const allDone = deps.every((d) => statuses.get(d) === 'done' || statuses.get(d) === 'compiled');
+
+    if (allDone) {
+      ready.push(s);
+    }
+  }
+
+  return ready;
+}
+
+module.exports = {
+  syncAll,
+  inferStatus,
+  findReady,
+};

package/lib/tracker.js

@@ -0,0 +1,124 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+/**
+ * Read sprint status from its directory.
+ * Looks for claims.json and compilation.json to determine state.
+ */
+function readSprintState(sprintPath, root) {
+  const absPath = path.isAbsolute(sprintPath) ? sprintPath : path.join(root, sprintPath);
+  const state = {
+    exists: false,
+    claimsCount: 0,
+    hasCompilation: false,
+    lastModified: null,
+    status: 'unknown',
+  };
+
+  if (!fs.existsSync(absPath)) return state;
+  state.exists = true;
+
+  const claimsPath = path.join(absPath, 'claims.json');
+  if (fs.existsSync(claimsPath)) {
+    try {
+      const claims = JSON.parse(fs.readFileSync(claimsPath, 'utf8'));
+      state.claimsCount = Array.isArray(claims) ? claims.length :
+        (claims.claims ? claims.claims.length : 0);
+      const stat = fs.statSync(claimsPath);
+      state.lastModified = stat.mtime;
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  const compilationPath = path.join(absPath, 'compilation.json');
+  state.hasCompilation = fs.existsSync(compilationPath);
+
+  // Infer status
+  if (state.claimsCount === 0) {
+    state.status = 'not-started';
+  } else if (state.hasCompilation) {
+    state.status = 'compiled';
+  } else {
+    state.status = 'in-progress';
+  }
+
+  return state;
+}
+
+/**
+ * Print status table for all sprints.
+ */
+function printStatus(config, root) {
+  const sprints = config.sprints || [];
+
+  if (sprints.length === 0) {
+    console.log('No sprints configured. Add sprints to orchard.json.');
+    return;
+  }
+
+  const active = sprints.filter((s) => s.status === 'active' || !s.status).length;
+  const done = sprints.filter((s) => s.status === 'done').length;
+
+  console.log('');
+  console.log(`  ${sprints.length} sprints tracked. ${active} active, ${done} done.`);
+  console.log('  ' + '-'.repeat(70));
+  console.log(
+    '  ' +
+    'Sprint'.padEnd(20) +
+    'Status'.padEnd(14) +
+    'Claims'.padEnd(10) +
+    'Assigned'.padEnd(16) +
+    'Deadline'
+  );
+  console.log('  ' + '-'.repeat(70));
+
+  for (const sprint of sprints) {
+    const state = readSprintState(sprint.path, root);
+    const name = path.basename(sprint.path).substring(0, 18);
+    const status = sprint.status || state.status;
+    const claims = state.claimsCount.toString();
+    const assignee = (sprint.assigned_to || '-').substring(0, 14);
+    const deadline = sprint.deadline || '-';
+
+    const statusDisplay =
+      status === 'active' ? '* active' :
+      status === 'done' ? 'x done' :
+      status === 'blocked' ? '! blocked' :
+      `  ${status}`;
+
+    console.log(
+      '  ' +
+      name.padEnd(20) +
+      statusDisplay.padEnd(14) +
+      claims.padEnd(10) +
+      assignee.padEnd(16) +
+      deadline
+    );
+  }
+
+  console.log('  ' + '-'.repeat(70));
+  console.log('');
+}
+
+/**
+ * Get status summary as data (for dashboard generation).
+ */
+function getStatusData(config, root) {
+  return (config.sprints || []).map((sprint) => {
+    const state = readSprintState(sprint.path, root);
+    return {
+      ...sprint,
+      state,
+      effectiveStatus: sprint.status || state.status,
+    };
+  });
+}
+
+module.exports = {
+  readSprintState,
+  printStatus,
+  getStatusData,
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@grainulation/orchard",
+  "version": "1.0.0",
+  "description": "Multi-sprint research orchestrator \u2014 coordinate parallel research across teams",
+  "main": "lib/planner.js",
+  "exports": {
+    ".": "./lib/planner.js",
+    "./server": "./lib/server.js",
+    "./sync": "./lib/sync.js",
+    "./tracker": "./lib/tracker.js",
+    "./doctor": "./lib/doctor.js",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "orchard": "bin/orchard.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "public/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/basic.test.js",
+    "start": "node bin/orchard.js status",
+    "serve": "node lib/server.js"
+  },
+  "keywords": [
+    "research",
+    "sprint",
+    "orchestrator",
+    "multi-sprint",
+    "wheat"
+  ],
+  "author": "grainulation contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grainulation/orchard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/grainulation/orchard/issues"
+  },
+  "homepage": "https://orchard.grainulation.com",
+  "engines": {
+    "node": ">=18"
+  }
+}