14 Commits

• fix: sync Cursor suggest-compact.js with corrected hooks version

  The .cursor copy had diverged from scripts/hooks/suggest-compact.js:
  - Fixed interval calculation: count % 25 → (count - threshold) % 25
    so suggestions fire relative to the configured threshold
  - Added upper bound clamp (<=1000000) to prevent counter corruption
    from large values converting to scientific notation strings
  - Removed unreliable String(process.ppid) fallback for session ID

  Affaan Mustafa · 2026-02-13 04:09:31 -08:00
  c93c218cb8
• fix: include .md files in instinct-cli glob (completes #216)

  The observer agent creates instinct files as .md with YAML frontmatter,
  but load_all_instincts() only globbed *.yaml and *.yml. Add *.md to the
  glob so instinct-cli status discovers all instinct files.

  Affaan Mustafa · 2026-02-13 01:26:37 -08:00
  e9343c844b
• fix: instinct-cli glob and evolve --generate (fixes #216, #217)

  - Load both .yaml and .yml files in load_all_instincts() (#216)
    The *.yaml-only glob missed .yml files, causing 'No instincts found'
  - Implement evolve --generate to create skill/command/agent files (#217)
    Previously printed a stub message. Now generates SKILL.md, command .md,
    and agent .md files from the clustering analysis into ~/.claude/homunculus/evolved/

  Affaan Mustafa · 2026-02-13 01:09:16 -08:00
  307ee05b2d
• fix: correct stale counts and broken paths across docs

  - .cursor/README.md: skills 30→37, commands ~28→31
  - .opencode/MIGRATION.md: fix rules paths (rules/ → rules/common/)
  - README.zh-CN.md: fix agent/skill/command counts
  - docs/ja-JP/README.md: fix agent/skill/command counts

  Affaan Mustafa · 2026-02-12 16:55:49 -08:00
  cb4378a0f6
• fix: broken cross-references, version sync, and enhanced command validator

  - Fix /build-and-fix → /build-fix in tdd.md, plan.md (+ cursor, zh-CN)
  - Fix non-existent explorer agent → planner in orchestrate.md (+ cursor, zh-CN, zh-TW)
  - Fix /python-test → /tdd in python-review.md (+ cursor, zh-CN)
  - Sync package.json version from 1.0.0 to 1.4.1 to match plugin.json
  - Enhance validate-commands.js with cross-reference checking:
    command refs, agent path refs, skill dir refs, workflow diagrams
  - Strip fenced code blocks before scanning to avoid false positives
  - Skip hypothetical "Creates:" lines in evolve.md examples
  - Add 46 new tests (suggest-compact, session-manager, utils, hooks)

  Affaan Mustafa · 2026-02-12 16:19:04 -08:00
  bc0520c6c1
• fix: migrate hooks to stdin JSON input, fix duplicate main() calls, add threshold validation

  - Migrate session-end.js and evaluate-session.js from CLAUDE_TRANSCRIPT_PATH
    env var to stdin JSON transcript_path (correct hook input mechanism)
  - Remove duplicate main() calls that ran before stdin was read, causing
    session files to be created with empty data
  - Add range validation (1-10000) on COMPACT_THRESHOLD in suggest-compact.js
    to prevent negative or absurdly large thresholds
  - Add integration/hooks.test.js to tests/run-all.js so CI runs all 97 tests
  - Update evaluate-session.sh to parse transcript_path from stdin JSON
  - Update hooks.test.js to pass transcript_path via stdin instead of env var
  - Sync .cursor/ copies

  Affaan Mustafa · 2026-02-12 15:33:55 -08:00
  ed7ec29ead
• fix: renameAlias data corruption, empty sessionId match, NaN threshold

  - Fix renameAlias() leaving orphaned newAlias key on save failure,
    causing in-memory data corruption with both old and new keys present
  - Add sessionPath validation to setAlias() to reject empty/null paths
  - Guard getSessionById() against empty string matching all sessions
    (startsWith('') is always true in JavaScript)
  - Fix suggest-compact.js NaN comparison when COMPACT_THRESHOLD env var
    is set to a non-numeric value — falls back to 50 instead of silently
    disabling the threshold check
  - Sync suggest-compact.js to .cursor/ copy

  Affaan Mustafa · 2026-02-12 14:30:10 -08:00
  63be081741
• fix: harden CI validators, shell scripts, and expand test suite

  - Add try-catch around readFileSync in validate-agents, validate-commands,
    validate-skills to handle TOCTOU races and file read errors
  - Add validate-hooks.js and all test suites to package.json test script
    (was only running 4/5 validators and 0/4 test files)
  - Fix shell variable injection in observe.sh: use os.environ instead of
    interpolating $timestamp/$OBSERVATIONS_FILE into Python string literals
  - Fix $? always being 0 in start-observer.sh: capture exit code before
    conditional since `if !` inverts the status
  - Add OLD_VERSION validation in release.sh and use pipe delimiter in sed
    to avoid issues with slash-containing values
  - Add jq dependency check in evaluate-session.sh before parsing config
  - Sync .cursor/ copies of all modified shell scripts

  Affaan Mustafa · 2026-02-12 14:11:33 -08:00
  f3a4b33d41
• chore: sync .cursor/ directory with latest agents, commands, and skills

  - Sync 13 agent files with updated descriptions and configurations
  - Sync 23 command files with latest YAML frontmatter and content
  - Sync 7 skill SKILL.md files with proper YAML frontmatter quoting
  - Copy missing cpp-testing and security-scan skills to .cursor/
  - Fix integration tests: send matching input to blocking hook test and
    expect correct exit code 2 (was 1)

  Affaan Mustafa · 2026-02-12 13:45:13 -08:00
  a756602523
• fix: remove dead export, harden session-aliases, sync .cursor scripts

  - Remove duplicate getAliasesPath() from utils.js (only used in
    session-aliases.js which has its own copy)
  - session-aliases.js: validate cleanupAliases param is a function,
    check saveAliases return value, guard resolveAlias against empty input
  - Sync .cursor/skills/strategic-compact/suggest-compact.sh with the
    fixed main version (CLAUDE_SESSION_ID instead of $$)

  Affaan Mustafa · 2026-02-12 13:43:53 -08:00
  7e852a5dc5
• fix: harden error handling, fix TOCTOU races, and improve test accuracy

  Core library fixes:
  - session-manager.js: wrap all statSync calls in try-catch to prevent
    TOCTOU crashes when files are deleted between readdir and stat
  - session-manager.js: use birthtime||ctime fallback for Linux compat
  - session-manager.js: remove redundant existsSync before readFile
  - utils.js: fix findFiles TOCTOU race on statSync inside readdir loop
  
  Hook improvements:
  - Add 1MB stdin buffer limits to all PostToolUse hooks to prevent
    unbounded memory growth from large payloads
  - suggest-compact.js: use fd-based atomic read+write for counter file
    to reduce race window between concurrent invocations
  - session-end.js: log when transcript file is missing, check
    replaceInFile return value for failed timestamp updates
  - start-observer.sh: log claude CLI failures instead of silently
    swallowing them, check observations file exists before analysis
  
  Test fixes:
  - Fix blocking hook tests to send matching input (dev server command)
    and expect correct exit code 2 instead of 1

  Affaan Mustafa · 2026-02-12 13:40:14 -08:00
  36864ea11a
• fix: sync .cursor observe.sh and fix suggest-compact.sh session tracking

  - Sync .cursor/observe.sh with corrected main version (use stdin pipe
    instead of broken heredoc json.loads pattern)
  - Fix suggest-compact.sh to use CLAUDE_SESSION_ID instead of $$ which
    gives a new PID per invocation, preventing counter from incrementing

  Affaan Mustafa · 2026-02-12 13:33:52 -08:00
  e1a0700067
• fix(sessions): also fix require() paths in Cursor and zh-CN sessions commands

  Same fix as the main sessions.md — use CLAUDE_PLUGIN_ROOT with
  ~/.claude/ fallback instead of relative paths.

  Affaan Mustafa · 2026-02-11 23:57:50 -08:00
  422467dbe0
• feat: add Cursor IDE support with pre-translated configs

  Add complete .cursor/ directory with rules, agents, skills, commands,
  and MCP config adapted for Cursor's format. This makes ecc-universal
  a truly cross-IDE package supporting Claude Code, Cursor, and OpenCode.
  
  - 27 rule files with YAML frontmatter (description, globs, alwaysApply)
  - 13 agent files with full model IDs and readonly flags
  - 30 skill directories (identical Agent Skills standard, no translation)
  - 31 command files (5 multi-* stubbed for missing codeagent-wrapper)
  - MCP config with Cursor env interpolation syntax
  - README.md and MIGRATION.md documentation
  - install.sh --target cursor flag for project-scoped installation
  - package.json updated with .cursor/ in files and cursor keywords

  Affaan Mustafa · 2026-02-11 02:31:52 -08:00
  261332dc50