archgraph-argo 0.10.23 → 0.10.25

package/install-argo.ps1

@@ -20,6 +20,10 @@ param(
     [string]$DshHome = "$env:USERPROFILE\.dsh",
     [string]$DshCwd = '',
     [string]$DshWorkspaces = '',
+    [string]$OpenClawHome = "$env:USERPROFILE\.openclaw",
+    [string]$OpenClawWorkspace = "$env:USERPROFILE\.openclaw\workspace",
+    [string]$OpenClawRepoRoot = '',
+    [switch]$SkipOpenClaw,
     [string]$McpPath
 )
 
@@ -265,47 +269,139 @@ function Get-WakeupGuideline {
     return $m.Groups[1].Value.Trim()
 }
 
-function Write-DshAgentRule {
-    # Merge the frontmatter-stripped ArchGraph rule into ~/.dsh/AGENTS.md,
-    # replacing the previous ArchGraph block while preserving surrounding user
-    # content. The rule body is injected verbatim - no adapter prose, so the
-    # working prompt stays identical to the Copilot / Cursor / OpenCode rules.
+function Write-ArchGraphRuleBlock {
+    # Merge the frontmatter-stripped ArchGraph rule into a target AGENTS.md
+    # file (DSH home or OpenClaw workspace), replacing the previous ArchGraph
+    # block while preserving surrounding user content. The rule body is
+    # injected verbatim - no adapter prose - so the working prompt stays
+    # identical to the Copilot / Cursor / OpenCode rules.
     param(
-        [string]$DshHome,
-        [string]$RuleText
+        [string]$DestPath,
+        [string]$RuleText,
+        [string]$Label
     )
     $ruleContent = Get-MarkdownBody -Content $RuleText
-    $dest = Join-Path $DshHome 'AGENTS.md'
     $marker = '<WakeupGuideline>'
-    New-Item -ItemType Directory -Force -Path $DshHome | Out-Null
-    if (Test-Path $dest) {
-        $existing = Get-Content $dest -Raw -Encoding UTF8
+    New-Item -ItemType Directory -Force -Path (Split-Path $DestPath) | Out-Null
+    if (Test-Path $DestPath) {
+        $existing = Get-Content $DestPath -Raw -Encoding UTF8
         if ($existing -like "*$marker*") {
             $endTag = '</ToolsGuideline>'
             $startIdx = $existing.IndexOf($marker)
             if ($startIdx -lt 0) { $startIdx = 0 }
             $endIdx = $existing.IndexOf($endTag, $startIdx)
             $before = $existing.Substring(0, $startIdx).TrimEnd()
-            if ($endIdx -lt 0) {
-                $combined = $before
-                if ($combined.Length -gt 0) { $combined += "`n`n" }
-                $combined += $ruleContent
-            } else {
-                $after = $existing.Substring($endIdx + $endTag.Length)
-                $combined = $before
-                if ($combined.Length -gt 0) { $combined += "`n`n" }
-                $combined += $ruleContent
-                if ($after.Length -gt 0) { $combined += $after }
-            }
-            [System.IO.File]::WriteAllText($dest, $combined, (New-Object System.Text.UTF8Encoding $false))
+            $after = ''
+            if ($endIdx -ge 0) { $after = $existing.Substring($endIdx + $endTag.Length).TrimStart() }
+            $combined = $before
+            if ($combined.Length -gt 0) { $combined += "`n`n" }
+            $combined += $ruleContent
+            if ($after.Length -gt 0) { $combined += "`n`n" + $after }
+            [System.IO.File]::WriteAllText($DestPath, $combined, (New-Object System.Text.UTF8Encoding $false))
         } else {
             $combined = $existing.TrimEnd() + "`n`n" + $ruleContent
-            [System.IO.File]::WriteAllText($dest, $combined, (New-Object System.Text.UTF8Encoding $false))
+            [System.IO.File]::WriteAllText($DestPath, $combined, (New-Object System.Text.UTF8Encoding $false))
         }
     } else {
-        [System.IO.File]::WriteAllText($dest, $ruleContent, (New-Object System.Text.UTF8Encoding $false))
+        [System.IO.File]::WriteAllText($DestPath, $ruleContent, (New-Object System.Text.UTF8Encoding $false))
     }
-    Write-Host "  DSH rule installed -> $dest"
+    Write-Host "  $Label installed -> $DestPath"
+}
+
+function Write-DshAgentRule {
+    # Merge the frontmatter-stripped ArchGraph rule into ~/.dsh/AGENTS.md
+    # (DeepSeek Harness user-global rule), replacing the previous ArchGraph
+    # block while preserving surrounding user content.
+    param(
+        [string]$DshHome,
+        [string]$RuleText
+    )
+    Write-ArchGraphRuleBlock -DestPath (Join-Path $DshHome 'AGENTS.md') -RuleText $RuleText -Label 'DSH rule'
+}
+
+function Write-OpenClawAgentRule {
+    # Deploy the ArchGraph rules into the OpenClaw agent workspace AGENTS.md.
+    # OpenClaw injects AGENTS.md into Project Context on every session (the
+    # same mechanism as the DSH / OpenCode AGENTS.md rules), so the
+    # UNCONDITIONAL STARTUP GATE is always active for OpenClaw agents.
+    param(
+        [string]$OpenClawWorkspace,
+        [string]$RuleText
+    )
+    Write-ArchGraphRuleBlock -DestPath (Join-Path $OpenClawWorkspace 'AGENTS.md') -RuleText $RuleText -Label 'OpenClaw rule'
+}
+
+function Write-OpenClawMcpConfig {
+    # Register the argo MCP server under mcp.servers.argo in
+    # ~/.openclaw/openclaw.json. OpenClaw is a fixed-workspace host: its
+    # embedded MCP client does not advertise MCP roots, so the workspace is
+    # pinned explicitly via env.ARGO_REPO_ROOT to the repository root this
+    # installer runs from. Only a real ArchGraph workspace (one that contains
+    # design/KG/SystemArchitecture.json) is pinned; when the installer runs
+    # from a non-workspace location (e.g. the npm-global archgraph-argo package
+    # dir via `argo-deploy`), an existing ARGO_REPO_ROOT is preserved instead
+    # of being clobbered, and a missing one is left unpinned with a hint.
+    # Existing config keys are preserved; a JSON5 (non strict JSON) config is
+    # left untouched with a manual-registration hint.
+    param(
+        [string]$OpenClawHome,
+        [string]$RepoRoot,
+        [string]$ArgoServer
+    )
+    $configPath = Join-Path $OpenClawHome 'openclaw.json'
+    $root = [ordered]@{}
+    $existingArgoRoot = ''
+    if (Test-Path $configPath) {
+        try {
+            $existing = Get-Content $configPath -Raw | ConvertFrom-Json
+            foreach ($p in $existing.PSObject.Properties) {
+                $root[$p.Name] = $p.Value
+            }
+            # Capture any previously pinned ARGO_REPO_ROOT so a non-workspace
+            # refresh (e.g. npm-global argo-deploy) cannot clobber a correct pin.
+            if ($null -ne $existing.mcp -and $null -ne $existing.mcp.servers `
+                -and $null -ne $existing.mcp.servers.argo -and $null -ne $existing.mcp.servers.argo.env `
+                -and $null -ne $existing.mcp.servers.argo.env.ARGO_REPO_ROOT) {
+                $existingArgoRoot = [string]$existing.mcp.servers.argo.env.ARGO_REPO_ROOT
+            }
+        } catch {
+            Write-Warning "  $configPath is not strict JSON (JSON5 with comments?); skipping argo MCP registration."
+            Write-Warning "  Register manually: openclaw mcp add argo --command node --arg `"$ArgoServer`" --env ARGO_REPO_ROOT=$RepoRoot"
+            return
+        }
+    }
+    $repoIsWorkspace = Test-Path (Join-Path $RepoRoot 'design\KG\SystemArchitecture.json')
+    $envBlock = [ordered]@{}
+    if ($repoIsWorkspace) {
+        $envBlock.ARGO_REPO_ROOT = $RepoRoot
+    } elseif ($existingArgoRoot) {
+        $envBlock.ARGO_REPO_ROOT = $existingArgoRoot
+        Write-Host "  $RepoRoot is not an ArchGraph workspace; preserving existing ARGO_REPO_ROOT=$existingArgoRoot"
+    } else {
+        Write-Warning "  $RepoRoot is not an ArchGraph workspace; not pinning ARGO_REPO_ROOT for OpenClaw."
+        Write-Warning "  Run install-argo.ps1 from the repository you want OpenClaw to serve, or set mcp.servers.argo.env.ARGO_REPO_ROOT manually."
+    }
+    $mcp = [ordered]@{}
+    if ($root.Contains('mcp') -and $null -ne $root['mcp']) {
+        foreach ($p in $root['mcp'].PSObject.Properties) { $mcp[$p.Name] = $p.Value }
+    }
+    $servers = [ordered]@{}
+    if ($mcp.Contains('servers') -and $null -ne $mcp['servers']) {
+        foreach ($p in $mcp['servers'].PSObject.Properties) { $servers[$p.Name] = $p.Value }
+    }
+    $argoServerObj = [ordered]@{
+        command = 'node'
+        args    = @($ArgoServer)
+    }
+    if ($envBlock.Count -gt 0) {
+        $argoServerObj.env = $envBlock
+    }
+    $servers['argo'] = $argoServerObj
+    $mcp['servers'] = $servers
+    $root['mcp'] = $mcp
+    New-Item -ItemType Directory -Force -Path $OpenClawHome | Out-Null
+    $json = $root | ConvertTo-Json -Depth 12
+    [System.IO.File]::WriteAllText($configPath, $json, (New-Object System.Text.UTF8Encoding $false))
 }
 
 function Write-DshManagedBlock {
@@ -618,63 +714,63 @@ Write-Host '==> Deploying Argo toolchain'
 
 $schemaSrc = Join-Path $argoDir 'schema'
 $schemaDest = Join-Path $ArgoRoot 'schema'
-Write-Host "[1/19] argo\schema -> $schemaDest"
+Write-Host "[1/22] argo\schema -> $schemaDest"
 Copy-Tree -Source $schemaSrc -Destination $schemaDest
 
 $scriptsSrc = Join-Path $argoDir 'scripts'
 $scriptsDest = Join-Path $ArgoRoot 'scripts'
-Write-Host "[2/19] argo\scripts -> $scriptsDest"
+Write-Host "[2/22] argo\scripts -> $scriptsDest"
 Copy-Tree -Source $scriptsSrc -Destination $scriptsDest
 
 $defaultsSrc = Join-Path $argoDir 'defaults'
 $defaultsDest = Join-Path $ArgoRoot 'defaults'
-Write-Host "[3/19] argo\defaults -> $defaultsDest"
+Write-Host "[3/22] argo\defaults -> $defaultsDest"
 Copy-Tree -Source $defaultsSrc -Destination $defaultsDest
 
 $skillSrc = Join-Path (Join-Path $argoDir 'skills') 'argo-init'
 $skillDest = Join-Path $SkillsRoot 'argo-init'
-Write-Host "[4/19] argo\skills\argo-init -> $skillDest"
+Write-Host "[4/22] argo\skills\argo-init -> $skillDest"
 Copy-Tree -Source $skillSrc -Destination $skillDest
 
 $ruleSrc = Join-Path (Join-Path $argoDir 'rules') 'archgraph.instructions.md'
 $ruleDest = Join-Path $PromptsRoot 'archgraph.instructions.md'
-Write-Host "[5/19] argo\rules\archgraph.instructions.md -> $ruleDest"
+Write-Host "[5/22] argo\rules\archgraph.instructions.md -> $ruleDest"
 New-Item -ItemType Directory -Force -Path $PromptsRoot | Out-Null
 Copy-Item -Force -Path $ruleSrc -Destination $ruleDest
 
 $depsSrc = Join-Path $argoDir 'package.json'
 $depsDest = Join-Path $ArgoRoot 'package.json'
-Write-Host "[6/19] argo\package.json -> $depsDest"
+Write-Host "[6/22] argo\package.json -> $depsDest"
 Copy-Item -Force -Path $depsSrc -Destination $depsDest
 
 $cursorSkillDest = Join-Path $CursorSkillsRoot 'argo-init'
-Write-Host "[7/19] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
+Write-Host "[7/22] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
 Copy-Tree -Source $skillSrc -Destination $cursorSkillDest
 
 $openCodeSkillDest = Join-Path $OpenCodeSkillsRoot 'argo-init'
-Write-Host "[8/19] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
+Write-Host "[8/22] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
 Copy-Tree -Source $skillSrc -Destination $openCodeSkillDest
 
-Write-Host "[9/19] argo\rules\archgraph.instructions.md -> $OpenCodeAgentsPath (OpenCode global AGENTS.md)"
+Write-Host "[9/22] argo\rules\archgraph.instructions.md -> $OpenCodeAgentsPath (OpenCode global AGENTS.md)"
 Add-AgentsRule -AgentsPath $OpenCodeAgentsPath -RulePath $ruleSrc
 
 $agentsSrc = Join-Path $argoDir 'agents'
-Write-Host "[10/19] argo\agents -> $CopilotAgentsRoot (Copilot user-level)"
+Write-Host "[10/22] argo\agents -> $CopilotAgentsRoot (Copilot user-level)"
 Copy-Agents -Source $agentsSrc -Destination $CopilotAgentsRoot
 
-Write-Host "[11/19] argo\agents -> $CursorAgentsRoot (Cursor user-level, converted to .md)"
+Write-Host "[11/22] argo\agents -> $CursorAgentsRoot (Cursor user-level, converted to .md)"
 Copy-Agents -Source $agentsSrc -Destination $CursorAgentsRoot -Target cursor
 
-Write-Host "[12/19] argo\agents -> $OpenCodeAgentsRoot (OpenCode user-level, converted to .md)"
+Write-Host "[12/22] argo\agents -> $OpenCodeAgentsRoot (OpenCode user-level, converted to .md)"
 Copy-Agents -Source $agentsSrc -Destination $OpenCodeAgentsRoot -Target opencode
 
 $pluginsSrc = Join-Path $argoDir 'plugins'
-Write-Host "[13/19] argo\plugins -> $PluginsRoot (Argo opencode plugins)"
+Write-Host "[13/22] argo\plugins -> $PluginsRoot (Argo opencode plugins)"
 Copy-Tree -Source $pluginsSrc -Destination $PluginsRoot
 
 $cursorRuleSrc = Join-Path (Join-Path $argoDir 'rules') 'archgraph.instructions.md'
 $cursorRuleDest = Join-Path $CursorRulesRoot 'archgraph.mdc'
-Write-Host "[14/19] argo\rules\archgraph.instructions.md -> $cursorRuleDest (Cursor global rule, alwaysApply)"
+Write-Host "[14/22] argo\rules\archgraph.instructions.md -> $cursorRuleDest (Cursor global rule, alwaysApply)"
 New-Item -ItemType Directory -Force -Path $CursorRulesRoot | Out-Null
 Convert-RuleFile -SourceFile $cursorRuleSrc -DestinationFile $cursorRuleDest
 
@@ -686,16 +782,16 @@ if ($SkipDsh) {
     $patchPath = Join-Path $DshHome 'cordis.patch.yml'
     $argoServer = (Join-Path $ArgoRoot 'scripts\argo-mcp-server.js').Replace('\', '/')
 
-    Write-Host "[15/19] argo\rules\archgraph.instructions.md -> $DshHome\AGENTS.md (DeepSeek Harness user-global rule, frontmatter stripped)"
+    Write-Host "[15/22] argo\rules\archgraph.instructions.md -> $DshHome\AGENTS.md (DeepSeek Harness user-global rule, frontmatter stripped)"
     Write-DshAgentRule -DshHome $DshHome -RuleText $ruleSrcContent
 
-    Write-Host "[16/19] argo\skills\argo-init -> $dshSkillDest (DeepSeek Harness skill)"
+    Write-Host "[16/22] argo\skills\argo-init -> $dshSkillDest (DeepSeek Harness skill)"
     Copy-Tree -Source (Join-Path $argoDir 'skills\argo-init') -Destination $dshSkillDest
 
-    Write-Host "[17/19] argo\rules\<WakeupGuideline> -> $DshHome\plugins\dsh-argo-wakeup\index.js (DeepSeek Harness wakeup plugin)"
+    Write-Host "[17/22] argo\rules\<WakeupGuideline> -> $DshHome\plugins\dsh-argo-wakeup\index.js (DeepSeek Harness wakeup plugin)"
     $wakeupDshPath = New-DshWakeupPlugin -DshHome $DshHome -RuleText $ruleSrcContent
 
-    Write-Host "[18/19] argo-workspace + argo-wakeup rows -> $patchPath (DeepSeek Harness MCP bridge + wakeup plugin)"
+    Write-Host "[18/22] argo-workspace + argo-wakeup rows -> $patchPath (DeepSeek Harness MCP bridge + wakeup plugin)"
     # The generated dsh-argo-workspace bridge connects directly to the argo
     # server (no dsh-mcp-client row), registers every tool as mcp__argo__* and
     # injects the current session's workspace (SessionHeader.cwd) as the
@@ -726,7 +822,7 @@ if ($SkipDsh) {
         Write-DshManagedBlock -Path $patchPath -Block $block -MarkerStart '# BEGIN ArchGraph ARGO deployment' -MarkerEnd '# END ArchGraph ARGO deployment'
     }
 
-    Write-Host "[19/19] argo\agents11 -> $DshHome\.agent-presets\<id> (DeepSeek Harness agent presets)"
+    Write-Host "[19/22] argo\agents -> $DshHome\.agent-presets\<id> (DeepSeek Harness agent presets)"
     New-DshAgentPresets -DshHome $DshHome -AgentsSrc (Join-Path $argoDir 'agents')
 
     Write-Host '  Restart `dsh web` to activate the MCP bridge and the wakeup plugin;'
@@ -736,6 +832,25 @@ if ($SkipDsh) {
     Write-Host '  the injected workspaceRoot unconditionally).'
 }
 
+if ($SkipOpenClaw) {
+    Write-Host 'Skipped OpenClaw integration (-SkipOpenClaw).'
+} else {
+    $ruleSrcContent = Get-Content $ruleSrc -Raw -Encoding UTF8
+    $openClawSkillDest = Join-Path $OpenClawHome 'skills\argo-init'
+    $openClawAgentsDest = Join-Path $OpenClawWorkspace 'AGENTS.md'
+
+    Write-Host '==> Deploying OpenClaw integration'
+    Write-Host "[20/22] argo\rules\archgraph.instructions.md -> $openClawAgentsDest (OpenClaw workspace AGENTS.md, frontmatter stripped)"
+    Write-OpenClawAgentRule -OpenClawWorkspace $OpenClawWorkspace -RuleText $ruleSrcContent
+
+    Write-Host "[21/22] argo\skills\argo-init -> $openClawSkillDest (OpenClaw managed skill, all agents)"
+    Copy-Tree -Source (Join-Path $argoDir 'skills\argo-init') -Destination $openClawSkillDest
+
+    Write-Host '  OpenClaw injects AGENTS.md into Project Context on every session, so the wakeup'
+    Write-Host '  gate (UNCONDITIONAL STARTUP GATE) is active on the next OpenClaw session; restart'
+    Write-Host '  the OpenClaw gateway (openclaw gateway restart) if it is already running.'
+}
+
 if ($SkipDeps) {
     Write-Host 'Skipped dependency install (-SkipDeps).'
 } elseif (Get-Command npm -ErrorAction SilentlyContinue) {
@@ -855,6 +970,15 @@ if ($SkipMcp) {
         enabled = $true
     })
     Write-Host "argo MCP config written -> $OpenCodeConfigPath"
+
+    if (-not $SkipOpenClaw) {
+        # The repo root to pin for OpenClaw defaults to the installer's own
+        # location; -OpenClawRepoRoot overrides it (e.g. for tests or when the
+        # installer runs from a non-workspace npm-global package dir).
+        $openClawRepoRoot = if ($OpenClawRepoRoot) { $OpenClawRepoRoot } else { $repoRoot }
+        Write-Host "[22/22] argo MCP server -> $(Join-Path $OpenClawHome 'openclaw.json') (OpenClaw mcp.servers.argo, env.ARGO_REPO_ROOT pinned)"
+        Write-OpenClawMcpConfig -OpenClawHome $OpenClawHome -RepoRoot $openClawRepoRoot -ArgoServer $argoServer
+    }
 }
 
 $wakeupPluginPath = Join-Path $PluginsRoot 'argo-wakeup.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archgraph-argo",
-  "version": "0.10.23",
+  "version": "0.10.25",
   "description": "Deploy the ArchGraph ARGO toolchain, skills, and rules (schema, scripts, argo-init skill, global rule) with one command.",
   "license": "MIT",
   "bin": {