Skip to main content

MC 101649 Tools Directory Governance

MC 101649 Tools Directory Governance

Verdict: PARTIAL / BLOCKED
Date: 2026-05-21
Task: [P3-3] Tools dir governance: archive 3,700+ stale files >60d; tools-manifest.json

Summary

A tools directory governance manifest was created and safe generated/cache artifacts were archived. The requested bulk archive of 3,700+ stale files was not completed because the dominant stale set is ~/system/tools/comms-agent/node_modules, and com.john.comms-agent is currently loaded/running from ~/system/tools/comms-agent/dist/index.js. Archiving those dependencies by age alone would risk breaking daemon restart.

Completed

  • Created ~/system/tools/tools-manifest.json with:
    • stale file inventory,
    • active/protected policy,
    • archive destination,
    • blocked archive candidates,
    • recommendation not to archive active daemon dependencies by mtime alone.
  • Archived safe generated/cache artifacts to ~/system/_archive/tools-governance-2026-05/ with manifest:
    • .DS_Store
    • .vercel/
    • .next/
    • __pycache__/
    • one malformed zero-byte tool-output filename, archived under a redacted/sanitized name.
  • Preserved active tools and daemon dependencies.

Blocker

~/system/tools/comms-agent/node_modules contains about 4,052 stale files (~130 MB), but com.john.comms-agent is loaded/running and daemon config points to ~/system/tools/comms-agent/dist/index.js. Do not move its dependencies until one of these is approved:

  1. retire/decommission com.john.comms-agent,
  2. stop daemon and validate dependency relocation + restart path,
  3. rebuild comms-agent so dependencies are reproducible elsewhere and LaunchAgent is updated.

Validation

  • tools-manifest.json JSON-valid.
  • Safe archive manifest JSON-valid.
  • mc.js stats smoke ran.
  • discover.js routing smoke ran.
  • cost-tracker.js summary today smoke ran.
  • bookstack-sync.js status ran; it reports pre-existing missing sync-map paths, but did not block this task's artifact validation.
  • launchctl list confirms com.john.comms-agent still loaded after safe archive.

Evidence

  • /tmp/101649-tools-inventory.txt
  • /tmp/101649-post-archive-inventory.txt
  • /tmp/101649-comms-agent-refs.txt
  • /tmp/101649-smoke-validation.txt
  • /tmp/101649-evidence/
  • ~/system/_archive/tools-governance-2026-05/manifest-101649-safe-archive.json
Back to top