delimit-cli 3.1.0 → 3.1.1

package/gateway/ai/backends/governance_bridge.py

@@ -145,7 +145,7 @@ def evaluate_trigger(action: str, context: Optional[Dict] = None, repo: str = ".
     return {
         "tool": "gov.evaluate",
         "status": "not_available",
-        "error": "Governance evaluation engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
         "action": action,
         "repo": repo,
     }
@@ -156,7 +156,7 @@ def new_task(title: str, scope: str, risk_level: str = "medium", repo: str = "."
     return {
         "tool": "gov.new_task",
         "status": "not_available",
-        "error": "Governance task engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
     }
 
 
@@ -165,7 +165,7 @@ def run_task(task_id: str, repo: str = ".") -> Dict[str, Any]:
     return {
         "tool": "gov.run",
         "status": "not_available",
-        "error": "Governance task engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
     }
 
 
@@ -174,7 +174,7 @@ def verify(task_id: str, repo: str = ".") -> Dict[str, Any]:
     return {
         "tool": "gov.verify",
         "status": "not_available",
-        "error": "Governance task engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
     }
 
 
@@ -183,7 +183,7 @@ def evidence_index(task_id: str, repo: str = ".") -> Dict[str, Any]:
     return {
         "tool": "gov.evidence_index",
         "status": "not_available",
-        "error": "Governance evidence engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
     }
 
 
@@ -192,5 +192,5 @@ def require_owner_approval(context: str, repo: str = ".") -> Dict[str, Any]:
     return {
         "tool": "gov.require_owner_approval",
         "status": "not_available",
-        "error": "Governance approval engine not running. This tool requires the governancegate package.",
+        "error": "Project not initialized for governance. Say 'initialize governance for this project' or run the delimit_init tool with your project path.",
     }

package/gateway/ai/backends/os_bridge.py

@@ -15,6 +15,12 @@ logger = logging.getLogger("delimit.ai.os_bridge")
 
 OS_PACKAGE = Path("/home/delimit/.delimit_suite/packages/delimit-os")
 
+_NOT_INIT_MSG = (
+    "Project not initialized for governance. "
+    "Say 'initialize governance for this project' "
+    "or run the delimit_init tool with your project path."
+)
+
 
 def _ensure_os_path():
     if str(OS_PACKAGE) not in sys.path:
@@ -47,7 +53,7 @@ def create_plan(operation: str, target: str, parameters: Optional[Dict] = None,
         PLANS[plan_id] = plan
         return plan
     except ImportError:
-        return {"error": "delimit-os not available", "fallback": True}
+        return {"error": _NOT_INIT_MSG, "fallback": True}
 
 
 def get_status() -> Dict[str, Any]:
@@ -62,7 +68,7 @@ def get_status() -> Dict[str, Any]:
             "tokens": len(TOKENS),
         }
     except ImportError:
-        return {"status": "unavailable", "error": "delimit-os not loaded"}
+        return {"status": "unavailable", "error": _NOT_INIT_MSG}
 
 
 def check_gates(plan_id: str) -> Dict[str, Any]:
@@ -79,4 +85,4 @@ def check_gates(plan_id: str) -> Dict[str, Any]:
             "status": plan.get("status"),
         }
     except ImportError:
-        return {"error": "delimit-os not available"}
+        return {"error": _NOT_INIT_MSG}

package/gateway/ai/server.py

@@ -21,9 +21,12 @@ All tools follow the Adapter Boundary Contract v1.0:
 
 import json
 import logging
+import os
+import shutil
 import subprocess
 import traceback
 from datetime import datetime, timezone
+from pathlib import Path
 from typing import Any, Dict, List, Optional
 
 from fastmcp import FastMCP
@@ -176,6 +179,84 @@ def delimit_zero_spec(
     return _safe_call(run_zero_spec, project_dir=project_dir, python_bin=python_bin)
 
 
+
+
+@mcp.tool()
+def delimit_init(
+    project_path: str = ".",
+    preset: str = "default",
+) -> Dict[str, Any]:
+    """Initialize Delimit governance for a project. Creates .delimit/policies.yml and ledger directory.
+
+    Args:
+        project_path: Project root directory.
+        preset: Policy preset — strict, default, or relaxed.
+    """
+    VALID_PRESETS = ("strict", "default", "relaxed")
+    if preset not in VALID_PRESETS:
+        return {
+            "error": "invalid_preset",
+            "message": f"Preset must be one of {VALID_PRESETS}, got '{preset}'",
+        }
+
+    root = Path(project_path).resolve()
+    delimit_dir = root / ".delimit"
+    policies_file = delimit_dir / "policies.yml"
+    ledger_dir = delimit_dir / "ledger"
+    events_file = ledger_dir / "events.jsonl"
+
+    # Idempotency check
+    if policies_file.exists() and ledger_dir.exists() and events_file.exists():
+        return {
+            "tool": "init",
+            "status": "already_initialized",
+            "project_path": str(root),
+            "preset": preset,
+            "message": f"Project already initialized at {delimit_dir}. No files overwritten.",
+        }
+
+    created = []
+
+    # 1. Create .delimit/ directory
+    if not delimit_dir.exists():
+        delimit_dir.mkdir(parents=True, exist_ok=True)
+        created.append(str(delimit_dir))
+
+    # 2. Create policies.yml from preset
+    if not policies_file.exists():
+        preset_source = Path(__file__).resolve().parent.parent / "core" / "policies" / f"{preset}.yml"
+        if preset_source.exists():
+            shutil.copy2(str(preset_source), str(policies_file))
+        else:
+            # Fallback: write a minimal default
+            fallback_content = (
+                    f"# Delimit Policy Preset: {preset}\n"
+                    "# Generated by delimit_init\n"
+                    "override_defaults: false\n"
+                    "rules: []\n"
+                )
+            policies_file.write_text(fallback_content)
+        created.append(str(policies_file))
+
+    # 3. Create ledger directory
+    if not ledger_dir.exists():
+        ledger_dir.mkdir(parents=True, exist_ok=True)
+        created.append(str(ledger_dir))
+
+    # 4. Create empty events.jsonl
+    if not events_file.exists():
+        events_file.touch()
+        created.append(str(events_file))
+
+    return {
+        "tool": "init",
+        "status": "initialized",
+        "project_path": str(root),
+        "preset": preset,
+        "created": created,
+        "message": f"Governance initialized with '{preset}' preset. {len(created)} items created.",
+    }
+
 # ═══════════════════════════════════════════════════════════════════════
 #  TIER 2: PLATFORM — OS, Governance, Memory, Vault
 # ═══════════════════════════════════════════════════════════════════════
@@ -252,7 +333,7 @@ def delimit_gov_policy(repo: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_gov_evaluate(action: str, context: Optional[Dict[str, Any]] = None, repo: str = ".") -> Dict[str, Any]:
-    """Evaluate if governance is required for an action.
+    """Evaluate if governance is required for an action (requires governancegate).
 
     Args:
         action: The action to evaluate.
@@ -265,7 +346,7 @@ def delimit_gov_evaluate(action: str, context: Optional[Dict[str, Any]] = None,
 
 @mcp.tool()
 def delimit_gov_new_task(title: str, scope: str, risk_level: str = "medium", repo: str = ".") -> Dict[str, Any]:
-    """Create a new governance task.
+    """Create a new governance task (requires governancegate).
 
     Args:
         title: Task title.
@@ -279,7 +360,7 @@ def delimit_gov_new_task(title: str, scope: str, risk_level: str = "medium", rep
 
 @mcp.tool()
 def delimit_gov_run(task_id: str, repo: str = ".") -> Dict[str, Any]:
-    """Run a governance task.
+    """Run a governance task (requires governancegate).
 
     Args:
         task_id: Task ID to run.
@@ -291,7 +372,7 @@ def delimit_gov_run(task_id: str, repo: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_gov_verify(task_id: str, repo: str = ".") -> Dict[str, Any]:
-    """Verify a governance task.
+    """Verify a governance task (requires governancegate).
 
     Args:
         task_id: Task ID to verify.
@@ -412,7 +493,7 @@ def delimit_deploy_publish(app: str, git_ref: Optional[str] = None) -> Dict[str,
 
 @mcp.tool()
 def delimit_deploy_verify(app: str, env: str, git_ref: Optional[str] = None) -> Dict[str, Any]:
-    """Verify deployment health.
+    """Verify deployment health (experimental).
 
     Args:
         app: Application name.
@@ -452,7 +533,7 @@ def delimit_deploy_status(app: str, env: str) -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_intel_dataset_register(name: str, schema: Dict[str, Any], description: Optional[str] = None) -> Dict[str, Any]:
-    """Register a new dataset with schema.
+    """Register a new dataset with schema (coming soon).
 
     Args:
         name: Dataset name.
@@ -465,14 +546,14 @@ def delimit_intel_dataset_register(name: str, schema: Dict[str, Any], descriptio
 
 @mcp.tool()
 def delimit_intel_dataset_list() -> Dict[str, Any]:
-    """List registered datasets."""
+    """List registered datasets (coming soon)."""
     from backends.intel_bridge import dataset_list
     return _safe_call(dataset_list)
 
 
 @mcp.tool()
 def delimit_intel_dataset_freeze(dataset_id: str) -> Dict[str, Any]:
-    """Mark dataset as immutable.
+    """Mark dataset as immutable (coming soon).
 
     Args:
         dataset_id: Dataset identifier.
@@ -483,7 +564,7 @@ def delimit_intel_dataset_freeze(dataset_id: str) -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_intel_snapshot_ingest(data: Dict[str, Any], provenance: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-    """Store research snapshot with provenance.
+    """Store research snapshot with provenance (coming soon).
 
     Args:
         data: Snapshot data.
@@ -495,7 +576,7 @@ def delimit_intel_snapshot_ingest(data: Dict[str, Any], provenance: Optional[Dic
 
 @mcp.tool()
 def delimit_intel_query(dataset_id: str, query: str, parameters: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-    """Execute deterministic query on dataset.
+    """Execute deterministic query on dataset (coming soon).
 
     Args:
         dataset_id: Dataset to query.
@@ -539,7 +620,7 @@ def delimit_generate_scaffold(project_type: str, name: str, packages: Optional[L
 
 @mcp.tool()
 def delimit_repo_diagnose(target: str = ".") -> Dict[str, Any]:
-    """Diagnose repository health issues.
+    """Diagnose repository health issues (experimental).
 
     Args:
         target: Repository path.
@@ -550,7 +631,7 @@ def delimit_repo_diagnose(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_repo_analyze(target: str = ".") -> Dict[str, Any]:
-    """Analyze repository structure and quality.
+    """Analyze repository structure and quality (experimental).
 
     Args:
         target: Repository path.
@@ -561,7 +642,7 @@ def delimit_repo_analyze(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_repo_config_validate(target: str = ".") -> Dict[str, Any]:
-    """Validate configuration files.
+    """Validate configuration files (experimental).
 
     Args:
         target: Repository or config path.
@@ -572,7 +653,7 @@ def delimit_repo_config_validate(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_repo_config_audit(target: str = ".") -> Dict[str, Any]:
-    """Audit configuration compliance.
+    """Audit configuration compliance (experimental).
 
     Args:
         target: Repository or config path.
@@ -596,7 +677,7 @@ def delimit_security_scan(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_security_audit(target: str = ".") -> Dict[str, Any]:
-    """Audit security compliance.
+    """Audit security compliance (experimental).
 
     Args:
         target: Repository or file path.
@@ -639,7 +720,7 @@ def delimit_evidence_verify(bundle_id: Optional[str] = None, bundle_path: Option
 
 @mcp.tool()
 def delimit_release_plan(environment: str, version: str, repository: str, services: Optional[List[str]] = None) -> Dict[str, Any]:
-    """Create deployment plan with approval gates.
+    """Create deployment plan with approval gates (experimental).
 
     Args:
         environment: Target environment (staging/production).
@@ -653,7 +734,7 @@ def delimit_release_plan(environment: str, version: str, repository: str, servic
 
 @mcp.tool()
 def delimit_release_validate(environment: str, version: str) -> Dict[str, Any]:
-    """Validate release readiness.
+    """Validate release readiness (experimental).
 
     Args:
         environment: Target environment.
@@ -665,7 +746,7 @@ def delimit_release_validate(environment: str, version: str) -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_release_status(environment: str) -> Dict[str, Any]:
-    """Check deployment status.
+    """Check deployment status (experimental).
 
     Args:
         environment: Target environment.
@@ -676,7 +757,7 @@ def delimit_release_status(environment: str) -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_release_rollback(environment: str, version: str, to_version: str) -> Dict[str, Any]:
-    """Rollback deployment to previous version.
+    """Rollback deployment to previous version (experimental).
 
     Args:
         environment: Target environment.
@@ -689,7 +770,7 @@ def delimit_release_rollback(environment: str, version: str, to_version: str) ->
 
 @mcp.tool()
 def delimit_release_history(environment: str, limit: int = 10) -> Dict[str, Any]:
-    """Show release history.
+    """Show release history (experimental).
 
     Args:
         environment: Target environment.
@@ -703,7 +784,7 @@ def delimit_release_history(environment: str, limit: int = 10) -> Dict[str, Any]
 
 @mcp.tool()
 def delimit_cost_analyze(target: str = ".") -> Dict[str, Any]:
-    """Analyze cost and spending patterns.
+    """Analyze cost and spending patterns (experimental).
 
     Args:
         target: Project or infrastructure path.
@@ -714,7 +795,7 @@ def delimit_cost_analyze(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_cost_optimize(target: str = ".") -> Dict[str, Any]:
-    """Generate cost optimization recommendations.
+    """Generate cost optimization recommendations (experimental).
 
     Args:
         target: Project or infrastructure path.
@@ -725,7 +806,7 @@ def delimit_cost_optimize(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_cost_alert(action: str = "list") -> Dict[str, Any]:
-    """Manage cost alerts and notifications.
+    """Manage cost alerts and notifications (experimental).
 
     Args:
         action: Action (list/create/delete/update).
@@ -738,7 +819,7 @@ def delimit_cost_alert(action: str = "list") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_data_validate(target: str = ".") -> Dict[str, Any]:
-    """Validate data integrity.
+    """Validate data integrity (experimental).
 
     Args:
         target: Data source or path.
@@ -749,7 +830,7 @@ def delimit_data_validate(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_data_migrate(target: str = ".") -> Dict[str, Any]:
-    """Execute data migration (plan-only by default).
+    """Execute data migration (experimental, plan-only by default).
 
     Args:
         target: Data source or migration path.
@@ -760,7 +841,7 @@ def delimit_data_migrate(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_data_backup(target: str = ".") -> Dict[str, Any]:
-    """Create data backups.
+    """Create data backups (experimental).
 
     Args:
         target: Data source to back up.
@@ -773,7 +854,7 @@ def delimit_data_backup(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_obs_metrics(query: str, time_range: str = "1h", source: Optional[str] = None) -> Dict[str, Any]:
-    """Query and analyze metrics.
+    """Query and analyze metrics (experimental).
 
     Args:
         query: Metrics query.
@@ -786,7 +867,7 @@ def delimit_obs_metrics(query: str, time_range: str = "1h", source: Optional[str
 
 @mcp.tool()
 def delimit_obs_logs(query: str, time_range: str = "1h", source: Optional[str] = None) -> Dict[str, Any]:
-    """Query and search logs.
+    """Query and search logs (experimental).
 
     Args:
         query: Log search query.
@@ -799,7 +880,7 @@ def delimit_obs_logs(query: str, time_range: str = "1h", source: Optional[str] =
 
 @mcp.tool()
 def delimit_obs_alerts(action: str, alert_rule: Optional[Dict[str, Any]] = None, rule_id: Optional[str] = None) -> Dict[str, Any]:
-    """Manage alerting rules.
+    """Manage alerting rules (experimental).
 
     Args:
         action: Action (list/create/delete/update).
@@ -812,7 +893,7 @@ def delimit_obs_alerts(action: str, alert_rule: Optional[Dict[str, Any]] = None,
 
 @mcp.tool()
 def delimit_obs_status() -> Dict[str, Any]:
-    """Get observability system status."""
+    """Get observability system status (experimental)."""
     from backends.ops_bridge import obs_status
     return _safe_call(obs_status)
 
@@ -821,7 +902,7 @@ def delimit_obs_status() -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_design_extract_tokens(figma_file_key: str, token_types: Optional[List[str]] = None) -> Dict[str, Any]:
-    """Extract design tokens from Figma.
+    """Extract design tokens from Figma (coming soon).
 
     Args:
         figma_file_key: Figma file key.
@@ -833,7 +914,7 @@ def delimit_design_extract_tokens(figma_file_key: str, token_types: Optional[Lis
 
 @mcp.tool()
 def delimit_design_generate_component(component_name: str, figma_node_id: Optional[str] = None, output_path: Optional[str] = None) -> Dict[str, Any]:
-    """Generate Next.js component from Figma design.
+    """Generate Next.js component from Figma design (coming soon).
 
     Args:
         component_name: Component name.
@@ -846,7 +927,7 @@ def delimit_design_generate_component(component_name: str, figma_node_id: Option
 
 @mcp.tool()
 def delimit_design_generate_tailwind(figma_file_key: str, output_path: Optional[str] = None) -> Dict[str, Any]:
-    """Generate Tailwind config from Figma design tokens.
+    """Generate Tailwind config from Figma design tokens (coming soon).
 
     Args:
         figma_file_key: Figma file key.
@@ -858,7 +939,7 @@ def delimit_design_generate_tailwind(figma_file_key: str, output_path: Optional[
 
 @mcp.tool()
 def delimit_design_validate_responsive(project_path: str, check_types: Optional[List[str]] = None) -> Dict[str, Any]:
-    """Validate responsive design patterns.
+    """Validate responsive design patterns (coming soon).
 
     Args:
         project_path: Project path to validate.
@@ -870,7 +951,7 @@ def delimit_design_validate_responsive(project_path: str, check_types: Optional[
 
 @mcp.tool()
 def delimit_design_component_library(project_path: str, output_format: str = "json") -> Dict[str, Any]:
-    """Generate component library documentation.
+    """Generate component library documentation (coming soon).
 
     Args:
         project_path: Project path.
@@ -884,7 +965,7 @@ def delimit_design_component_library(project_path: str, output_format: str = "js
 
 @mcp.tool()
 def delimit_story_generate(component_path: str, story_name: Optional[str] = None, variants: Optional[List[str]] = None) -> Dict[str, Any]:
-    """Generate Storybook story for a component.
+    """Generate Storybook story for a component (coming soon).
 
     Args:
         component_path: Path to the component file.
@@ -897,7 +978,7 @@ def delimit_story_generate(component_path: str, story_name: Optional[str] = None
 
 @mcp.tool()
 def delimit_story_visual_test(url: str, project_path: Optional[str] = None, threshold: float = 0.05) -> Dict[str, Any]:
-    """Run visual regression test with Playwright screenshots.
+    """Run visual regression test with Playwright screenshots (coming soon).
 
     Args:
         url: URL to test.
@@ -910,7 +991,7 @@ def delimit_story_visual_test(url: str, project_path: Optional[str] = None, thre
 
 @mcp.tool()
 def delimit_story_build(project_path: str, output_dir: Optional[str] = None) -> Dict[str, Any]:
-    """Build Storybook static site.
+    """Build Storybook static site (coming soon).
 
     Args:
         project_path: Project path.
@@ -922,7 +1003,7 @@ def delimit_story_build(project_path: str, output_dir: Optional[str] = None) ->
 
 @mcp.tool()
 def delimit_story_accessibility(project_path: str, standards: str = "WCAG2AA") -> Dict[str, Any]:
-    """Run WCAG accessibility tests on components.
+    """Run WCAG accessibility tests on components (coming soon).
 
     Args:
         project_path: Project path.
@@ -936,7 +1017,7 @@ def delimit_story_accessibility(project_path: str, standards: str = "WCAG2AA") -
 
 @mcp.tool()
 def delimit_test_generate(project_path: str, source_files: Optional[List[str]] = None, framework: str = "jest") -> Dict[str, Any]:
-    """Generate tests for source code.
+    """Generate tests for source code (experimental).
 
     Args:
         project_path: Project path.
@@ -949,7 +1030,7 @@ def delimit_test_generate(project_path: str, source_files: Optional[List[str]] =
 
 @mcp.tool()
 def delimit_test_coverage(project_path: str, threshold: int = 80) -> Dict[str, Any]:
-    """Analyze test coverage.
+    """Analyze test coverage (experimental).
 
     Args:
         project_path: Project path.
@@ -961,7 +1042,7 @@ def delimit_test_coverage(project_path: str, threshold: int = 80) -> Dict[str, A
 
 @mcp.tool()
 def delimit_test_smoke(project_path: str, test_suite: Optional[str] = None) -> Dict[str, Any]:
-    """Run smoke tests.
+    """Run smoke tests (experimental).
 
     Args:
         project_path: Project path.
@@ -975,7 +1056,7 @@ def delimit_test_smoke(project_path: str, test_suite: Optional[str] = None) -> D
 
 @mcp.tool()
 def delimit_docs_generate(target: str = ".") -> Dict[str, Any]:
-    """Generate documentation for a project.
+    """Generate documentation for a project (experimental).
 
     Args:
         target: Project path.
@@ -986,7 +1067,7 @@ def delimit_docs_generate(target: str = ".") -> Dict[str, Any]:
 
 @mcp.tool()
 def delimit_docs_validate(target: str = ".") -> Dict[str, Any]:
-    """Validate documentation quality and completeness.
+    """Validate documentation quality and completeness (experimental).
 
     Args:
         target: Project path.
@@ -1128,7 +1209,7 @@ async def delimit_sensor_github_issue(
 def delimit_version() -> Dict[str, Any]:
     """Return Delimit unified server version, all tiers, and tool count."""
     tiers = {
-        "tier1_core": ["lint", "diff", "policy", "ledger", "impact", "semver", "explain", "zero_spec"],
+        "tier1_core": ["lint", "diff", "policy", "ledger", "impact", "semver", "explain", "zero_spec", "init"],
         "tier2_platform": [
             "os.plan", "os.status", "os.gates",
             "gov.health", "gov.status", "gov.policy", "gov.evaluate", "gov.new_task", "gov.run", "gov.verify",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "delimit-cli",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "AI agent guardrails for developers. Install governance tools into Claude Code with one command.",
   "main": "index.js",
   "bin": {