declare-cc 1.0.7 → 2.0.0

package/hooks/declare-activity.js

@@ -1,106 +0,0 @@
-#!/usr/bin/env node
-// Declare activity hook — PreToolUse + PostToolUse
-// Writes interesting tool events to .planning/activity.jsonl
-// Server watches .planning/ via fs.watch and pushes SSE events to dashboard.
-//
-// Installed for PreToolUse and PostToolUse hook events.
-// Runs fast: read stdin → decide → append one line → exit.
-
-'use strict';
-
-const fs   = require('fs');
-const path = require('path');
-const os   = require('os');
-
-const cwd          = process.cwd();
-const planningDir  = path.join(cwd, '.planning');
-const activityFile = path.join(planningDir, 'activity.jsonl');
-
-// Only write if .planning/ exists (i.e. this is a Declare project)
-if (!fs.existsSync(planningDir)) process.exit(0);
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', c => raw += c);
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(raw);
-    const event = buildEvent(data);
-    if (!event) process.exit(0);
-
-    // Ensure file exists
-    if (!fs.existsSync(activityFile)) fs.writeFileSync(activityFile, '');
-
-    // Append event + trim to last 200 lines
-    const line = JSON.stringify(event) + '\n';
-    fs.appendFileSync(activityFile, line);
-
-    // Trim to last 200 lines to avoid unbounded growth
-    const content = fs.readFileSync(activityFile, 'utf8');
-    const lines = content.split('\n').filter(Boolean);
-    if (lines.length > 200) {
-      fs.writeFileSync(activityFile, lines.slice(-200).join('\n') + '\n');
-    }
-  } catch (_) {
-    // Silent fail — never block Claude
-  }
-  process.exit(0);
-});
-
-/**
- * Build an activity event from a hook payload, or return null to skip.
- * @param {any} data
- * @returns {object|null}
- */
-function buildEvent(data) {
-  const tool      = data.tool_name || '';
-  const input     = data.tool_input || {};
-  const response  = data.tool_response;
-  const hookEvent = data.hook_event_name || ''; // PreToolUse or PostToolUse
-  const ts        = Date.now();
-  const phase     = hookEvent === 'PostToolUse' ? 'done' : 'start';
-
-  // Task spawns — most important for agent visibility
-  if (tool === 'Task') {
-    return {
-      ts, phase, tool: 'Task',
-      desc:  input.description || '',
-      agent: input.subagent_type || '',
-      // truncate prompt to avoid massive payloads
-      prompt: (input.prompt || '').slice(0, 200),
-      bg: hookEvent === 'PostToolUse',
-    };
-  }
-
-  // Bash commands that involve declare-tools (execution steps)
-  if (tool === 'Bash') {
-    const cmd = input.command || '';
-    if (cmd.includes('declare-tools') || cmd.includes('/declare:')) {
-      return { ts, phase, tool: 'Bash', cmd: cmd.slice(0, 200) };
-    }
-    return null; // skip noisy general bash
-  }
-
-  // Write tool — track planning file changes + auto-sync on SUMMARY.md writes
-  if (tool === 'Write' && hookEvent === 'PostToolUse') {
-    const fp = input.file_path || '';
-    if (fp.includes('.planning/')) {
-      // When an executor writes A-XX-SUMMARY.md, auto-run sync-status so
-      // PLAN.md and MILESTONES.md update immediately without manual intervention
-      if (fp.includes('-SUMMARY.md')) {
-        const { execSync } = require('child_process');
-        try {
-          execSync(`node "${path.join(cwd, '.claude', 'declare-tools.cjs')}" sync-status`, {
-            cwd,
-            timeout: 10000,
-            stdio: 'ignore',
-          });
-        } catch (_) { /* silent — never block Claude */ }
-      }
-      return { ts, phase: 'done', tool: 'Write', file: fp.replace(cwd, '.') };
-    }
-    return null;
-  }
-
-  return null;
-}

package/hooks/declare-check-update.js

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-// Check for Declare updates in background, write result to cache
-// Called by SessionStart hook - runs once per session
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawn } = require('child_process');
-
-const homeDir = os.homedir();
-const cwd = process.cwd();
-const cacheDir = path.join(homeDir, '.claude', 'cache');
-const cacheFile = path.join(cacheDir, 'declare-update-check.json');
-
-// VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(cwd, '.claude', 'declare', 'VERSION');
-const globalVersionFile = path.join(homeDir, '.claude', 'declare', 'VERSION');
-
-// Ensure cache directory exists
-if (!fs.existsSync(cacheDir)) {
-  fs.mkdirSync(cacheDir, { recursive: true });
-}
-
-// Run check in background (spawn background process, windowsHide prevents console flash)
-const child = spawn(process.execPath, ['-e', `
-  const fs = require('fs');
-  const { execSync } = require('child_process');
-
-  const cacheFile = ${JSON.stringify(cacheFile)};
-  const projectVersionFile = ${JSON.stringify(projectVersionFile)};
-  const globalVersionFile = ${JSON.stringify(globalVersionFile)};
-
-  // Check project directory first (local install), then global
-  let installed = '0.0.0';
-  try {
-    if (fs.existsSync(projectVersionFile)) {
-      installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
-    } else if (fs.existsSync(globalVersionFile)) {
-      installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
-    }
-  } catch (e) {}
-
-  let latest = null;
-  try {
-    latest = execSync('npm view declare-cc version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
-  } catch (e) {}
-
-  const result = {
-    update_available: latest && installed !== latest,
-    installed,
-    latest: latest || 'unknown',
-    checked: Math.floor(Date.now() / 1000)
-  };
-
-  fs.writeFileSync(cacheFile, JSON.stringify(result));
-`], {
-  stdio: 'ignore',
-  windowsHide: true,
-  detached: true  // Required on Windows for proper process detachment
-});
-
-child.unref();

package/hooks/declare-server.js

@@ -1,116 +0,0 @@
-#!/usr/bin/env node
-// Declare dashboard server — SessionStart hook
-//
-// On every Claude Code session start (for a Declare project):
-//   1. Derive a stable port for this project (hash of cwd, range 3847-4846)
-//   2. If a server is already running on that port for THIS project, leave it
-//   3. If a server is running on that port for a DIFFERENT project, kill it
-//   4. Start a fresh server for the current project
-//   5. Write the port to .planning/server.port for /declare:dashboard to read
-//
-// This means each project gets its own port, servers survive between sessions,
-// and switching projects always gives you the right server.
-
-'use strict';
-
-const fs     = require('fs');
-const path   = require('path');
-const http   = require('http');
-const cp     = require('child_process');
-
-const cwd         = process.cwd();
-const planningDir = path.join(cwd, '.planning');
-
-// Only run for Declare projects
-if (!fs.existsSync(planningDir)) process.exit(0);
-
-const PORT_BASE  = 3847;
-const PORT_RANGE = 1000; // ports 3847–4846
-
-/**
- * Simple djb2 hash to derive a stable port from the project path.
- * @param {string} str
- * @returns {number} port in [PORT_BASE, PORT_BASE + PORT_RANGE)
- */
-function projectPort(str) {
-  let h = 5381;
-  for (let i = 0; i < str.length; i++) {
-    h = ((h << 5) + h) ^ str.charCodeAt(i);
-    h = h >>> 0; // keep unsigned 32-bit
-  }
-  return PORT_BASE + (h % PORT_RANGE);
-}
-
-const port = projectPort(cwd);
-const portFile = path.join(planningDir, 'server.port');
-const bundle   = path.join(cwd, '.claude', 'declare-tools.cjs');
-
-// If bundle doesn't exist, nothing to do
-if (!fs.existsSync(bundle)) process.exit(0);
-
-/**
- * Ask the running server on `port` which cwd it's serving, via /api/graph.
- * Returns the project name or null if nothing is running / not a Declare server.
- */
-function checkRunningServer(port, callback) {
-  const req = http.get(`http://127.0.0.1:${port}/api/graph`, { timeout: 1500 }, res => {
-    let body = '';
-    res.on('data', c => body += c);
-    res.on('end', () => {
-      try {
-        const data = JSON.parse(body);
-        // If it has a valid graph response it's our server
-        callback(data && !data.error ? 'declare' : null);
-      } catch { callback(null); }
-    });
-  });
-  req.on('error', () => callback(null));
-  req.on('timeout', () => { req.destroy(); callback(null); });
-}
-
-/**
- * Kill any process currently listening on the given port.
- */
-function killPort(port) {
-  try {
-    const pid = cp.execSync(`lsof -ti :${port} 2>/dev/null`, { encoding: 'utf8' }).trim();
-    if (pid) {
-      pid.split('\n').forEach(p => {
-        try { process.kill(parseInt(p), 'SIGTERM'); } catch {}
-      });
-    }
-  } catch {}
-}
-
-/**
- * Start the dashboard server for this project in the background.
- */
-function startServer() {
-  // Write port file before spawning so /declare:dashboard always finds it
-  try { fs.writeFileSync(portFile, String(port)); } catch {}
-
-  const child = cp.spawn(process.execPath, [bundle, 'serve', '--port', String(port)], {
-    cwd,
-    detached: true,
-    stdio: 'ignore',
-  });
-  child.unref();
-}
-
-// Check if something is already running on this port
-checkRunningServer(port, status => {
-  if (status === 'declare') {
-    // A Declare server is already up on our port.
-    // It might be from a previous session for this same project — reuse it.
-    // Write port file to make sure /declare:dashboard finds it.
-    try { fs.writeFileSync(portFile, String(port)); } catch {}
-    process.exit(0);
-  }
-
-  // Nothing running (or non-Declare process) — kill whatever is there and start fresh
-  killPort(port);
-  setTimeout(() => {
-    startServer();
-    process.exit(0);
-  }, 300);
-});

package/hooks/declare-statusline.js

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-// Claude Code Statusline - Declare Edition
-// Shows: model | current task | directory | context usage
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Read JSON from stdin
-let input = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => input += chunk);
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(input);
-    const model = data.model?.display_name || 'Claude';
-    const dir = data.workspace?.current_dir || process.cwd();
-    const session = data.session_id || '';
-    const remaining = data.context_window?.remaining_percentage;
-
-    // Context window display (shows USED percentage scaled to 80% limit)
-    // Claude Code enforces an 80% context limit, so we scale to show 100% at that point
-    let ctx = '';
-    if (remaining != null) {
-      const rem = Math.round(remaining);
-      const rawUsed = Math.max(0, Math.min(100, 100 - rem));
-      // Scale: 80% real usage = 100% displayed
-      const used = Math.min(100, Math.round((rawUsed / 80) * 100));
-
-      // Build progress bar (10 segments)
-      const filled = Math.floor(used / 10);
-      const bar = '█'.repeat(filled) + '░'.repeat(10 - filled);
-
-      // Color based on scaled usage (thresholds adjusted for new scale)
-      if (used < 63) {        // ~50% real
-        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
-      } else if (used < 81) { // ~65% real
-        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
-      } else if (used < 95) { // ~76% real
-        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
-      } else {
-        ctx = ` \x1b[5;31m💀 ${bar} ${used}%\x1b[0m`;
-      }
-    }
-
-    // Current task from todos
-    let task = '';
-    const homeDir = os.homedir();
-    const todosDir = path.join(homeDir, '.claude', 'todos');
-    if (session && fs.existsSync(todosDir)) {
-      try {
-        const files = fs.readdirSync(todosDir)
-          .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
-          .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
-          .sort((a, b) => b.mtime - a.mtime);
-
-        if (files.length > 0) {
-          try {
-            const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
-            const inProgress = todos.find(t => t.status === 'in_progress');
-            if (inProgress) task = inProgress.activeForm || '';
-          } catch (e) {}
-        }
-      } catch (e) {
-        // Silently fail on file system errors - don't break statusline
-      }
-    }
-
-    // Declare update available?
-    let gsdUpdate = '';
-    const cacheFile = path.join(homeDir, '.claude', 'cache', 'declare-update-check.json');
-    if (fs.existsSync(cacheFile)) {
-      try {
-        const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
-        if (cache.update_available) {
-          gsdUpdate = '\x1b[33m⬆ /declare:update\x1b[0m │ ';
-        }
-      } catch (e) {}
-    }
-
-    // Output
-    const dirname = path.basename(dir);
-    if (task) {
-      process.stdout.write(`${gsdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[1m${task}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
-    } else {
-      process.stdout.write(`${gsdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
-    }
-  } catch (e) {
-    // Silent fail - don't break statusline on parse errors
-  }
-});

package/scripts/build-hooks.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/**
- * Copy GSD hooks to dist for installation.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const HOOKS_DIR = path.join(__dirname, '..', 'hooks');
-const DIST_DIR = path.join(HOOKS_DIR, 'dist');
-
-// Hooks to copy (pure Node.js, no bundling needed)
-const HOOKS_TO_COPY = [
-  'gsd-check-update.js',
-  'gsd-statusline.js'
-];
-
-function build() {
-  // Ensure dist directory exists
-  if (!fs.existsSync(DIST_DIR)) {
-    fs.mkdirSync(DIST_DIR, { recursive: true });
-  }
-
-  // Copy hooks to dist
-  for (const hook of HOOKS_TO_COPY) {
-    const src = path.join(HOOKS_DIR, hook);
-    const dest = path.join(DIST_DIR, hook);
-
-    if (!fs.existsSync(src)) {
-      console.warn(`Warning: ${hook} not found, skipping`);
-      continue;
-    }
-
-    console.log(`Copying ${hook}...`);
-    fs.copyFileSync(src, dest);
-    console.log(`  → ${dest}`);
-  }
-
-  console.log('\nBuild complete.');
-}
-
-build();

package/scripts/release.js

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-// Release script: bump version, build, commit, tag.
-// Usage: npm run release -- <version>
-// Example: npm run release -- 0.5.6
-//
-// After this runs, publish manually:
-//   npm publish --otp=<your-2fa-code>
-//   git push && git push --tags
-
-'use strict';
-
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const version = process.argv[2];
-if (!version || !/^\d+\.\d+\.\d+$/.test(version)) {
-  console.error('Usage: npm run release -- <version>  (e.g. 0.5.6)');
-  process.exit(1);
-}
-
-const root = path.join(__dirname, '..');
-const pkgPath = path.join(root, 'package.json');
-
-function run(cmd) {
-  console.log(`> ${cmd}`);
-  execSync(cmd, { cwd: root, stdio: 'inherit' });
-}
-
-// 1. Bump version in package.json
-const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-const prev = pkg.version;
-pkg.version = version;
-fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
-console.log(`Bumped ${prev} → ${version}`);
-
-// 2. Build
-run('npm run build');
-
-// 3. Commit + tag
-run(`git add package.json package-lock.json dist/`);
-run(`git commit -m "chore: bump version to ${version}"`);
-run(`git tag -f v${version}`);
-
-console.log(`
-Done. To publish:
-
-  npm publish --otp=<your-2fa-code>
-  git push && git push --tags
-`);

package/templates/future.md

@@ -1,4 +0,0 @@
-# Future: [Project Name]
-
-<!-- Each declaration is a standalone truth statement about the future. -->
-<!-- Edit freely -- the system validates on load, not on save. -->

package/templates/milestones.md

@@ -1,11 +0,0 @@
-# Milestones & Actions: [Project Name]
-
-## Milestones
-
-| ID | Title | Status | Realizes | Caused By |
-|----|-------|--------|----------|-----------|
-
-## Actions
-
-| ID | Title | Status | Causes |
-|----|-------|--------|--------|

package/workflows/actions.md

@@ -1,89 +0,0 @@
-# Action Plan Derivation Workflow
-
-You are guiding a user through action plan derivation: for each milestone, working backward to determine the concrete actions that must be done to make the milestone true.
-
-## Opening
-
-Show the milestones being processed:
-
-> Let's derive action plans for your milestones -- the concrete steps to make each one true.
->
-> Milestones to plan:
-> - M-01: [title] (realizes D-XX)
-> - M-02: [title] (realizes D-XX)
-> ...
->
-> For each milestone, I'll ask: "For this to be true, what must be done?" Each answer becomes an action with a clear artifact or state change it produces.
-
-If deriving for a specific milestone (argument provided), focus on just that one:
-
-> Let's derive an action plan for:
-> - [M-XX]: [title]
-
-## Per-Milestone Derivation Loop
-
-For each milestone M that needs a plan:
-
-### a. State the backward question
-
-> For "[M title]" to be true, what must be done?
-
-### b. Derive actions (2-6 per milestone)
-
-For each proposed action:
-
-- **Title:** clear, action-oriented (e.g., "Build authentication middleware", "Write migration script")
-- **Produces:** what artifact or state change results (e.g., "auth middleware module", "migrated database schema")
-- **Atomicity check:** Can this be completed in one focused session? Does it produce a verifiable artifact? Is "done" clear?
-  - If YES: include as an action.
-  - If NO: it may need to be split or may actually be a sub-milestone.
-
-Err on the side of "atomic enough" -- over-decomposition creates bloat. If something is borderline, treat it as a single action.
-
-### c. Present complete plan for approval
-
-Show all proposed actions together as a coherent plan:
-
-> Here's the proposed plan for M-XX "[milestone title]":
->
-> 1. **[Action A]** -- produces [what]
-> 2. **[Action B]** -- produces [what]
-> 3. **[Action C]** -- produces [what]
->
-> This plan will be presented for your approval.
-
-The command will present this for user approval via AskUserQuestion.
-
-### d. Handle adjustments
-
-If the user wants changes:
-- Add, remove, rename, or reorder actions as requested
-- Re-present the adjusted plan for approval
-
-If the user approves: signal the command to persist via create-plan.
-
-### e. Move to next milestone
-
-After a plan is approved and persisted, move to the next milestone.
-
-## Closing
-
-After all milestones have plans:
-
-> Action derivation complete.
->
-> Created plans for [X] milestones with [Y] total actions.
->
-> Run `/declare:status` to see coverage and health.
-
-## Design Principles
-
-Follow these throughout the conversation:
-
-- **Actions are derived and presented as a complete plan per milestone**, not individually. The user reviews the whole plan at once.
-- **"What must be done?" is the core question.** Keep the backward reasoning visible.
-- **Each action should be atomic** -- single focused session, verifiable artifact, clear "done" state.
-- **Err toward atomic enough.** Over-decomposition creates bloat. If something could be one action or two, lean toward one.
-- **Show your reasoning.** For each action, explain what it produces and why it's needed.
-- **Propose, don't dictate.** The user may have better ideas about how to decompose their work.
-- **Do not use emojis.** Keep the tone professional and grounded.