code-context-control 2.44.1__py3-none-any.whl → 2.46.0__py3-none-any.whl

cli/c3.py

@@ -85,7 +85,7 @@ console = Console() if HAS_RICH else None
 # Config
 CONFIG_DIR = ".c3"
 CONFIG_FILE = ".c3/config.json"
-__version__ = "2.44.1"
+__version__ = "2.46.0"
 
 
 def _command_deps() -> CommandDeps:
@@ -239,7 +239,7 @@ _C3_MCP_ALLOW = [
     "mcp__c3__c3_memory", "mcp__c3__c3_validate", "mcp__c3__c3_edit",
     "mcp__c3__c3_agent", "mcp__c3__c3_delegate", "mcp__c3__c3_edits",
     "mcp__c3__c3_impact", "mcp__c3__c3_shell", "mcp__c3__c3_bitbucket",
-    "mcp__c3__c3_project",
+    "mcp__c3__c3_project", "mcp__c3__c3_task", "mcp__c3__c3_artifacts",
 ]
 
 # Obsolete MCP tool names from earlier C3 versions. `c3 permissions clean`
@@ -4980,6 +4980,11 @@ def cmd_install_mcp(args):
         ) from e
 
     print(f"Wrote {mcp_config_path}")
+    if not profile.config_path_global:
+        # Self-report to the artifact tracker: attribute this write to C3
+        # instead of letting it surface as anonymous out-of-band drift.
+        from services.artifact_defs import note_pending_write
+        note_pending_write(target, profile.config_path, "install_mcp")
     if profile.name in {"codex", "gemini"}:
         _ensure_project_session_configs(target, server_script, primary_profile=profile.name, c3_mcp_exe=c3_mcp_exe)
         _ensure_global_session_fallbacks(server_script, c3_mcp_exe=c3_mcp_exe)
@@ -5181,6 +5186,8 @@ def cmd_install_mcp(args):
             json.dump(settings, f, indent=2)
 
         print(f"Wrote {settings_path}")
+        from services.artifact_defs import note_pending_write
+        note_pending_write(target, profile.settings_path, "install_mcp")
         print(f"  Hooks ({hook_event}): dispatcher (1 spawn/event) — filter/ghost/read-guard/ledger/unlock/signal via cli/hook_dispatch.py posttool")
         print(f"  Hooks ({pre_event}): dispatcher — {read_matcher}/{grep_matcher}/{glob_matcher}/{edit_matcher}/{write_matcher} (c3 enforcement)")
         print("  Hooks (Stop): dispatcher — session_stats + auto_snapshot + terse_advisor")

cli/commands/common.py

@@ -202,7 +202,7 @@ def cmd_claudemd(args, deps: CommandDeps):
             output_path = Path(project_path) / instructions_file
             # Wrap in the C3 managed block; preserve user content outside it.
             from services.claude_md import write_c3_instruction_doc
-            write_c3_instruction_doc(output_path, content)
+            write_c3_instruction_doc(output_path, content, project_path=project_path)
             print(f"{instructions_file} saved to {output_path} ({tokens} tokens)")
 
     elif args.claudemd_cmd == "check":

cli/docs.html

@@ -1148,7 +1148,7 @@ python cli/c3.py install-mcp . gemini</code></pre>
 
       <!-- ─── MCP Tools ───────────────────── -->
       <h2 id="mcp-tools">MCP Tools Reference</h2>
-      <p>C3 exposes 16 MCP tools. All core tools work without Ollama; delegate requires it. The Bitbucket integration is optional and activated via <code>c3 bitbucket login</code>.</p>
+      <p>C3 exposes 18 MCP tools. All core tools work without Ollama; delegate requires it. The Bitbucket integration is optional and activated via <code>c3 bitbucket login</code>.</p>
 
       <h3>Discovery &amp; Compression</h3>
       <table>
@@ -2672,7 +2672,7 @@ c3 session load | claude --resume</code></pre>
   <strong>MCP Proxy</strong> ──── Dynamic tool filtering + context injection (optional, opt-in via MCP config)
        | Subprocess stdio (NDJSON)
        v
-  <strong>C3 MCP Server</strong> ─── 26 tools: search, compress, session, memory, CLAUDE.md, context, hybrid, notifications...
+  <strong>C3 MCP Server</strong> ─── 18 tools: search, compress, session, memory, edits, tasks, artifacts, delegate...
        |
        +── <em>Compression</em>      <em>Smart Index</em>
        |    AST Summary       TF-IDF + Code Structure
@@ -2861,7 +2861,7 @@ c3 session load | claude --resume</code></pre>
       <pre><code>claude-companion/
   cli/
     c3.py                # CLI entry point (all commands)
-    mcp_server.py        # MCP server (30 tools via FastMCP)
+    mcp_server.py        # MCP server (18 tools via FastMCP)
     mcp_proxy.py         # Optional advanced MCP proxy (tool filtering)
     server.py            # Flask web server + REST API
     ui.html              # Single-page React dashboard

cli/guide/index.html

@@ -309,7 +309,7 @@
       <a href="tools.html" class="nav-card">
         <span class="nav-card-icon">🔧</span>
         <div class="nav-card-title">Tools Reference</div>
-        <div class="nav-card-desc">Full reference for all 16 MCP tools — params, examples, notes</div>
+        <div class="nav-card-desc">Full reference for all 18 MCP tools — params, examples, notes</div>
       </a>
       <a href="bitbucket.html" class="nav-card">
         <span class="nav-card-icon">🪣</span>
@@ -509,6 +509,36 @@
             <td><span class="badge badge-yellow">Ledger</span></td>
             <td>Edit ledger: history, versions, audit trail</td>
           </tr>
+          <tr>
+            <td><code>c3_impact</code></td>
+            <td><span class="badge badge-purple">Analysis</span></td>
+            <td>Blast-radius check before editing shared symbols</td>
+          </tr>
+          <tr>
+            <td><code>c3_shell</code></td>
+            <td><span class="badge badge-green">Execute</span></td>
+            <td>Structured shell exec — tests, git, build (auto-filtered)</td>
+          </tr>
+          <tr>
+            <td><code>c3_task</code></td>
+            <td><span class="badge badge-yellow">PM</span></td>
+            <td>Durable tasks, milestones, and decision notes per project</td>
+          </tr>
+          <tr>
+            <td><code>c3_artifacts</code></td>
+            <td><span class="badge badge-yellow">Config</span></td>
+            <td>Agent-config tracking: history, diff &amp; restore for CLAUDE.md, settings, MCP configs, skills</td>
+          </tr>
+          <tr>
+            <td><code>c3_bitbucket</code></td>
+            <td><span class="badge badge-orange">SCM</span></td>
+            <td>Bitbucket Data Center: PRs, branches, builds, repo admin</td>
+          </tr>
+          <tr>
+            <td><code>c3_project</code></td>
+            <td><span class="badge badge-cyan">Multi-project</span></td>
+            <td>Discover &amp; operate on other c3-installed projects</td>
+          </tr>
         </tbody>
       </table>
 

cli/guide/tools.html

@@ -118,9 +118,11 @@
     <div class="sidebar-section">
       <div class="sidebar-label">Ledger</div>
       <a href="#c3_edits"    class="sidebar-link"><span class="icon">📝</span> c3_edits</a>
+      <a href="#c3_artifacts" class="sidebar-link"><span class="icon">🛡️</span> c3_artifacts</a>
     </div>
     <div class="sidebar-section">
       <div class="sidebar-label">SCM</div>
+      <a href="#c3_task" class="sidebar-link"><span class="icon">✅</span> c3_task</a>
       <a href="#c3_bitbucket" class="sidebar-link"><span class="icon">🪣</span> c3_bitbucket</a>
     </div>
     <div class="sidebar-section">
@@ -134,7 +136,7 @@
 
     <div class="page-hero">
       <h1>Tools Reference</h1>
-      <p>Complete reference for all 16 C3 MCP tools — parameters, actions, examples, and usage notes.</p>
+      <p>Complete reference for all 18 C3 MCP tools — parameters, actions, examples, and usage notes.</p>
     </div>
 
     <!-- TOC -->
@@ -155,6 +157,8 @@
         <a href="#c3_delegate" class="toc-item">c3_delegate <span class="cat">AI</span></a>
         <a href="#c3_agent"    class="toc-item">c3_agent    <span class="cat">AI</span></a>
         <a href="#c3_edits"    class="toc-item">c3_edits    <span class="cat">Ledger</span></a>
+        <a href="#c3_task" class="toc-item">c3_task <span class="cat">PM</span></a>
+        <a href="#c3_artifacts" class="toc-item">c3_artifacts <span class="cat">Config</span></a>
         <a href="#c3_bitbucket" class="toc-item">c3_bitbucket <span class="cat">SCM</span></a>
         <a href="#c3_project"  class="toc-item">c3_project  <span class="cat">Multi-project</span></a>
       </div>
@@ -1090,6 +1094,96 @@ c3_edits(action=<span class="str">'history'</span>, branch=<span class="str">'fe
         </div>
       </div>
 
+      <!-- c3_task -->
+      <div class="tool-card" id="c3_task">
+        <div class="tool-card-header">
+          <span class="tool-name">c3_task</span>
+          <div class="tag-row">
+            <span class="badge badge-purple">pm</span>
+            <span class="badge">v2.45.0</span>
+          </div>
+          <span class="tool-tagline">Durable per-project tasks, milestones, and decision notes — the project-management layer</span>
+        </div>
+        <div class="tool-card-body">
+          <p class="tool-desc">Every C3 project carries a PM store at <code>.c3/pm/pm.json</code>: tasks with status (backlog / in_progress / blocked / done), priority (p0–p3), due dates, tags, and code links (files, commits, edit-ledger entries); milestones with computed progress; and a decision-note log separate from AI memory. The same store powers the Hub's Tasks tab and kanban board, the per-project UI's Tasks tab, and this tool. Task ids accept any unique prefix (≥4 chars); milestones resolve by id or unique name. Read actions are plan-mode-safe. Ephemeral session plans stay in <code>c3_session(action='plan')</code>.</p>
+
+          <h4>Actions</h4>
+          <table class="params-table">
+            <thead><tr><th>Action</th><th>Group</th><th>Description</th></tr></thead>
+            <tbody>
+              <tr><td class="param-name">add</td><td>Write</td><td class="param-desc">Create a task: <code>title</code> + optional description / priority / due_date (YYYY-MM-DD) / tags (CSV) / milestone</td></tr>
+              <tr><td class="param-name">update, done, archive</td><td>Write</td><td class="param-desc"><code>task_id</code> + changed fields; <code>done</code> stamps completion; archive keeps history</td></tr>
+              <tr><td class="param-name">list, get, board</td><td>Read</td><td class="param-desc">Filtered list (status/priority/tags/milestone/query), full detail, kanban columns + milestone progress</td></tr>
+              <tr><td class="param-name">link, unlink</td><td>Write</td><td class="param-desc"><code>task_id</code> + <code>link_type</code> (file | commit | edit) + <code>ref</code> — tie tasks to the code they touch</td></tr>
+              <tr><td class="param-name">milestone_add / _update / _list / _archive</td><td>Both</td><td class="param-desc">Milestones with target dates; list shows progress %; archive detaches its tasks</td></tr>
+              <tr><td class="param-name">note_add, note_list</td><td>Both</td><td class="param-desc">Dated notes; <code>kind='decision'</code> for the decision log</td></tr>
+            </tbody>
+          </table>
+
+          <h4>Examples</h4>
+          <pre><code><span class="com"># Capture a task while coding</span>
+c3_task(action=<span class="str">'add'</span>, title=<span class="str">'Harden pm.json against concurrent writes'</span>,
+        priority=<span class="str">'p1'</span>, tags=<span class="str">'pm,backend'</span>)
+
+<span class="com"># Tie it to the code it touches, then finish it</span>
+c3_task(action=<span class="str">'link'</span>, task_id=<span class="str">'a1b2c3d4'</span>, link_type=<span class="str">'file'</span>, ref=<span class="str">'services/task_store.py'</span>)
+c3_task(action=<span class="str">'done'</span>, task_id=<span class="str">'a1b2'</span>)
+
+<span class="com"># Milestones + the board</span>
+c3_task(action=<span class="str">'milestone_add'</span>, name=<span class="str">'v2.46'</span>, target_date=<span class="str">'2026-08-01'</span>)
+c3_task(action=<span class="str">'board'</span>)
+
+<span class="com"># Record a decision</span>
+c3_task(action=<span class="str">'note_add'</span>, note=<span class="str">'Kanban rank uses float sort keys'</span>, kind=<span class="str">'decision'</span>)</code></pre>
+
+          <p class="tool-desc"><strong>Surfaces:</strong> the Hub shows a Tasks tab per project (drill-in panel), <code>☑ N</code> open-task chips on cards, and a global kanban board behind the Projects | Tasks switcher. Hub mutations audit <code>pm_write</code> events to the project's activity log. Disable with <code>hybrid.pm.enabled=false</code>.</p>
+        </div>
+      </div>
+
+      <!-- c3_artifacts -->
+      <div class="tool-card" id="c3_artifacts">
+        <div class="tool-card-header">
+          <span class="tool-name">c3_artifacts</span>
+          <div class="tag-row">
+            <span class="badge badge-purple">agent config</span>
+            <span class="badge">v2.46.0</span>
+          </div>
+          <span class="tool-tagline">Version history, diff, and restore for the files that shape the agent itself</span>
+        </div>
+        <div class="tool-card-body">
+          <p class="tool-desc">C3 tracks every <em>agent-affecting artifact</em> across all IDEs it knows — instruction docs (<code>CLAUDE.md</code>, <code>AGENTS.md</code>, <code>GEMINI.md</code>, <code>.cursorrules</code>, <code>.github/copilot-instructions.md</code>), settings/hooks (<code>.claude/settings*.json</code>), MCP configs (<code>.mcp.json</code>, <code>.codex/config.toml</code>, <code>.gemini/settings.json</code>, …), and Claude Code extensions (<code>.claude/</code> skills, agents, commands, plugins). Content-addressed snapshots land in <code>.c3/agent_artifacts/</code>; every change is a history event with attribution: <code>c3_edit</code> (this session), <code>hook</code> (native Edit/Write), <code>scan</code> (out-of-band — you edited it in an editor), <code>install_mcp</code> (C3 regenerating its own files), or <code>restore</code>. A background agent scans every ~2 min and warns only when <em>settings or MCP configs</em> change outside C3. Artifact refs accept an id (<code>skill:browcontrol</code>), unique prefix, or plain path (<code>CLAUDE.md</code>). Everything except <code>restore</code> is plan-mode-safe.</p>
+
+          <h4>Actions</h4>
+          <table class="params-table">
+            <thead><tr><th>Action</th><th>Group</th><th>Description</th></tr></thead>
+            <tbody>
+              <tr><td class="param-name">scan</td><td>Read</td><td class="param-desc">Refresh the inventory; captures out-of-band changes immediately (idempotent — unchanged files emit nothing)</td></tr>
+              <tr><td class="param-name">list</td><td>Read</td><td class="param-desc">Inventory with versions; filters: <code>cls</code> (instructions | settings | mcp | skill | agent | command | plugin), <code>provider</code></td></tr>
+              <tr><td class="param-name">history</td><td>Read</td><td class="param-desc">Change events newest-first, with source attribution; <code>artifact</code> optional (all events when omitted)</td></tr>
+              <tr><td class="param-name">show</td><td>Read</td><td class="param-desc">Content at a version (<code>version=0</code> → live file)</td></tr>
+              <tr><td class="param-name">diff</td><td>Read</td><td class="param-desc">Unified diff <code>version</code> → <code>against</code> (omit <code>against</code> to diff vs live)</td></tr>
+              <tr><td class="param-name">restore</td><td>Write</td><td class="param-desc">Write a prior version's exact bytes back. Forward-only (new version + history event, never rewrites), cross-logged to the edit ledger, warns on settings/managed-block files. Resurrects deleted artifacts.</td></tr>
+              <tr><td class="param-name">status</td><td>Read</td><td class="param-desc">Tracked counts by class, out-of-band changes, last scan, pending signals</td></tr>
+            </tbody>
+          </table>
+
+          <h4>Examples</h4>
+          <pre><code><span class="com"># What changed behind my back?</span>
+c3_artifacts(action=<span class="str">'status'</span>)
+c3_artifacts(action=<span class="str">'history'</span>, limit=<span class="num">10</span>)
+
+<span class="com"># Someone (or something) touched the hooks — inspect and roll back</span>
+c3_artifacts(action=<span class="str">'diff'</span>, artifact=<span class="str">'.claude/settings.local.json'</span>, version=<span class="num">3</span>)
+c3_artifacts(action=<span class="str">'restore'</span>, artifact=<span class="str">'settings:.claude/settings.local.json'</span>, version=<span class="num">3</span>)
+
+<span class="com"># Track a skill's evolution</span>
+c3_artifacts(action=<span class="str">'history'</span>, artifact=<span class="str">'skill:browcontrol'</span>)
+c3_artifacts(action=<span class="str">'show'</span>, artifact=<span class="str">'skill:browcontrol'</span>, version=<span class="num">2</span>)</code></pre>
+
+          <p class="tool-desc"><strong>Surfaces:</strong> the Hub drill-in panel gets an Artifacts tab (class-grouped inventory, per-version timeline, diff viewer, two-step restore); REST at <code>/api/artifacts*</code> per project and <code>/api/projects/artifacts*</code> on the hub. Changes made through <code>c3_edit</code> and <code>install-mcp</code> self-attribute — only genuinely foreign edits show as <code>scan</code>. Disable with <code>hybrid.agent_artifacts.enabled=false</code>.</p>
+        </div>
+      </div>
+
       <!-- c3_bitbucket -->
       <div class="tool-card" id="c3_bitbucket">
         <div class="tool-card-header">

cli/hook_artifact.py

@@ -0,0 +1,67 @@
+"""PostToolUse hook: signal agent-artifact writes for attributed capture.
+
+Fires alongside the edit ledger on Edit/Write/NotebookEdit. When the touched
+file classifies as an agent-affecting artifact (instruction docs, settings/
+hooks, MCP configs, .claude skills/agents/commands — see
+services/artifact_defs), appends a one-line pending signal to
+.c3/agent_artifacts/pending.jsonl.
+
+Performance: no hashing, no manifest lock — the ArtifactScanAgent consumes
+signals asynchronously and attributes the resulting history events to
+source='hook'. Silent hook: never emits user-visible output.
+"""
+
+import json
+import sys
+from pathlib import Path
+
+# Add project root to path for imports
+_project_root = str(Path(__file__).resolve().parent.parent)
+if _project_root not in sys.path:
+    sys.path.insert(0, _project_root)
+
+from cli._hook_utils import get_tool_input_path, log_hook_error, normalize_tool_name  # noqa: E402
+from services.artifact_defs import classify_path, note_pending_write  # noqa: E402
+
+
+def run(payload: dict, project_path: Path | None = None) -> None:
+    """Core logic — importable by the dispatcher and tests. Always None."""
+    tool_name = normalize_tool_name(payload.get("tool_name", ""))
+    if tool_name not in ("Edit", "Write", "NotebookEdit"):
+        return None
+
+    file_path = get_tool_input_path(payload)
+    if not file_path:
+        return None
+
+    if project_path is None:
+        project_path = Path.cwd()
+    if not (project_path / ".c3").exists():
+        return None  # Not a C3 project
+
+    try:
+        rel = str(Path(file_path).resolve().relative_to(project_path.resolve()))
+    except (ValueError, OSError):
+        return None  # outside the project → not a project artifact
+
+    if classify_path(rel) is None:
+        return None
+
+    note_pending_write(project_path, rel, "hook",
+                       session_id=payload.get("session_id", "") or "",
+                       tool=tool_name)
+    return None
+
+
+def main():
+    try:
+        raw = sys.stdin.read()
+        if not raw.strip():
+            return
+        run(json.loads(raw))
+    except Exception as _e:
+        log_hook_error("hook_artifact", _e)
+
+
+if __name__ == "__main__":
+    main()

cli/hook_dispatch.py

@@ -96,6 +96,7 @@ def _routes(event: str, raw_tool: str, norm_tool: str):
             yield "hook_c3_signal"
         if norm_tool in _LEDGER_TOOLS:
             yield "hook_edit_ledger"
+            yield "hook_artifact"
         if raw_tool in _GHOST_TOOLS:
             yield "hook_ghost_files"
     elif event == "stop":