@dp-pcs/ogp 0.3.3 → 0.4.3

package/dist/shared/config.js

@@ -1,25 +1,31 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-const DEFAULT_CONFIG_DIR = process.env.OGP_HOME ?? path.join(os.homedir(), '.ogp');
-const CONFIG_FILE = path.join(DEFAULT_CONFIG_DIR, 'config.json');
-export function getConfigPath() {
-    return CONFIG_FILE;
-}
+/**
+ * Get the config directory (computed dynamically based on OGP_HOME)
+ */
 export function getConfigDir() {
-    return DEFAULT_CONFIG_DIR;
+    return process.env.OGP_HOME ?? path.join(os.homedir(), '.ogp');
+}
+/**
+ * Get the config file path (computed dynamically based on OGP_HOME)
+ */
+export function getConfigPath() {
+    return path.join(getConfigDir(), 'config.json');
 }
 export function ensureConfigDir() {
-    if (!fs.existsSync(DEFAULT_CONFIG_DIR)) {
-        fs.mkdirSync(DEFAULT_CONFIG_DIR, { recursive: true });
+    const configDir = getConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
     }
 }
 export function loadConfig() {
     try {
-        if (!fs.existsSync(CONFIG_FILE)) {
+        const configFile = getConfigPath();
+        if (!fs.existsSync(configFile)) {
             return null;
         }
-        const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        const data = fs.readFileSync(configFile, 'utf-8');
         return JSON.parse(data);
     }
     catch (error) {
@@ -29,7 +35,8 @@ export function loadConfig() {
 }
 export function saveConfig(config) {
     ensureConfigDir();
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    const configFile = getConfigPath();
+    fs.writeFileSync(configFile, JSON.stringify(config, null, 2), 'utf-8');
 }
 export function requireConfig() {
     const config = loadConfig();

package/dist/shared/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAgEzB,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACnF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;AAEjE,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvC,EAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,eAAe,EAAE,CAAC;IAClB,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AA4IzB;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,eAAe,EAAE,CAAC;IAClB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/framework-detection.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Detected framework information
+ */
+export interface DetectedFramework {
+    id: string;
+    name: string;
+    detected: boolean;
+    suggestedConfigDir: string;
+    suggestedPort: number;
+}
+/**
+ * Detect installed AI frameworks
+ *
+ * @returns Array of detected frameworks with installation status and suggested configuration
+ */
+export declare function detectFrameworks(): DetectedFramework[];
+/**
+ * Get the first detected framework (preferred installation)
+ * Priority: OpenClaw > Hermes > Standalone
+ *
+ * @returns The first detected framework, or standalone if none detected
+ */
+export declare function getPreferredFramework(): DetectedFramework;
+/**
+ * Get framework by ID
+ *
+ * @param id Framework ID ('openclaw', 'hermes', or 'standalone')
+ * @returns Framework details or null if not found
+ */
+export declare function getFrameworkById(id: string): DetectedFramework | null;
+//# sourceMappingURL=framework-detection.d.ts.map

package/dist/shared/framework-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-detection.d.ts","sourceRoot":"","sources":["../../src/shared/framework-detection.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAgCD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CA2BtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAGrE"}

package/dist/shared/framework-detection.js

@@ -0,0 +1,91 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { execFileSync } from 'node:child_process';
+/**
+ * Check if a command exists in PATH
+ * Uses which/where command (safe, no shell injection risk)
+ */
+function commandExists(command) {
+    try {
+        const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+        execFileSync(whichCommand, [command], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if OpenClaw is installed
+ */
+function isOpenClawInstalled() {
+    const openclawDir = path.join(os.homedir(), '.openclaw');
+    return fs.existsSync(openclawDir) || commandExists('openclaw');
+}
+/**
+ * Check if Hermes is installed
+ */
+function isHermesInstalled() {
+    const hermesDir = path.join(os.homedir(), '.hermes');
+    return fs.existsSync(hermesDir) || commandExists('hermes');
+}
+/**
+ * Detect installed AI frameworks
+ *
+ * @returns Array of detected frameworks with installation status and suggested configuration
+ */
+export function detectFrameworks() {
+    const openclawDetected = isOpenClawInstalled();
+    const hermesDetected = isHermesInstalled();
+    return [
+        {
+            id: 'openclaw',
+            name: 'OpenClaw',
+            detected: openclawDetected,
+            suggestedConfigDir: path.join(os.homedir(), '.ogp-openclaw'),
+            suggestedPort: 18790,
+        },
+        {
+            id: 'hermes',
+            name: 'Hermes',
+            detected: hermesDetected,
+            suggestedConfigDir: path.join(os.homedir(), '.ogp-hermes'),
+            suggestedPort: 18793,
+        },
+        {
+            id: 'standalone',
+            name: 'Standalone',
+            detected: true, // Always available as fallback
+            suggestedConfigDir: path.join(os.homedir(), '.ogp'),
+            suggestedPort: 18790,
+        },
+    ];
+}
+/**
+ * Get the first detected framework (preferred installation)
+ * Priority: OpenClaw > Hermes > Standalone
+ *
+ * @returns The first detected framework, or standalone if none detected
+ */
+export function getPreferredFramework() {
+    const frameworks = detectFrameworks();
+    // Return first detected framework (OpenClaw has priority, then Hermes)
+    const detected = frameworks.find(f => f.id !== 'standalone' && f.detected);
+    if (detected) {
+        return detected;
+    }
+    // Fallback to standalone
+    return frameworks.find(f => f.id === 'standalone');
+}
+/**
+ * Get framework by ID
+ *
+ * @param id Framework ID ('openclaw', 'hermes', or 'standalone')
+ * @returns Framework details or null if not found
+ */
+export function getFrameworkById(id) {
+    const frameworks = detectFrameworks();
+    return frameworks.find(f => f.id === id) || null;
+}
+//# sourceMappingURL=framework-detection.js.map

package/dist/shared/framework-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-detection.js","sourceRoot":"","sources":["../../src/shared/framework-detection.ts"],"names":[],"mappings":"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"}

package/dist/shared/help.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Show context-sensitive help based on command chain
+ */
+export declare function showContextHelp(commandChain: string[]): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/shared/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/shared/help.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAwB5D"}

package/dist/shared/help.js

@@ -0,0 +1,281 @@
+import { loadPeers } from '../daemon/peers.js';
+import { loadMetaConfig } from './meta-config.js';
+/**
+ * Show context-sensitive help based on command chain
+ */
+export function showContextHelp(commandChain) {
+    const context = commandChain.join(' ').trim();
+    if (!context) {
+        showTopLevelHelp();
+    }
+    else if (context === 'federation') {
+        showFederationHelp();
+    }
+    else if (context.startsWith('federation send')) {
+        showFederationSendHelp();
+    }
+    else if (context.startsWith('federation agent')) {
+        showFederationAgentHelp();
+    }
+    else if (context === 'agent-comms') {
+        showAgentCommsHelp();
+    }
+    else if (context === 'config') {
+        showConfigHelp();
+    }
+    else if (context === 'project') {
+        showProjectHelp();
+    }
+    else if (context === 'intent') {
+        showIntentHelp();
+    }
+    else {
+        // Fallback to generic help
+        console.log(`No specific help available for: ${context}`);
+        console.log('Try: ogp --help or ogp <command> --help');
+    }
+}
+/**
+ * Top-level commands help
+ */
+function showTopLevelHelp() {
+    console.log('\nAvailable commands:');
+    console.log('  setup           Initialize OGP configuration');
+    console.log('  start           Start OGP daemon');
+    console.log('  stop            Stop OGP daemon');
+    console.log('  status          Show daemon status');
+    console.log('  federation      Manage federation with peers');
+    console.log('  agent-comms     Configure agent-to-agent communication policies');
+    console.log('  project         Manage project contexts for collaboration');
+    console.log('  intent          Manage custom intent handlers');
+    console.log('  config          Manage framework configuration');
+    console.log('  expose          Expose daemon via tunnel (cloudflared/ngrok)');
+    console.log('  expose-stop     Stop background tunnel');
+    console.log('  shutdown        Stop both daemon and tunnel');
+    console.log('  install         Install LaunchAgent (macOS)');
+    console.log('  uninstall       Uninstall LaunchAgent (macOS)');
+    console.log('');
+    console.log('Global options:');
+    console.log('  --for <framework>  Select framework to use');
+    console.log('  --help            Show help');
+    console.log('  --version         Show version');
+    console.log('');
+    console.log('Examples:');
+    console.log('  ogp setup');
+    console.log('  ogp setup --reset-keypair');
+    console.log('  ogp start');
+    console.log('  ogp --for hermes federation list');
+    console.log('  ogp federation ?');
+    console.log('');
+}
+/**
+ * Federation commands help
+ */
+function showFederationHelp() {
+    console.log('\nFederation commands:');
+    console.log('  list            List all federated peers');
+    console.log('  status          Show federation status and alias mappings');
+    console.log('  request         Send federation request to a peer');
+    console.log('  connect         Connect to a peer via optional rendezvous lookup');
+    console.log('  invite          Generate optional invite token for a peer');
+    console.log('  accept          Accept an optional rendezvous invite token');
+    console.log('  approve         Approve a pending federation request');
+    console.log('  reject          Reject a pending federation request');
+    console.log('  remove          Remove a peer from federation list');
+    console.log('  alias           Set a user-friendly alias for a peer');
+    console.log('  ping            Test connectivity to a peer');
+    console.log('  send            Send a message to a federated peer');
+    console.log('  agent           Send an agent-comms message to a peer');
+    console.log('  scopes          Show scope grants for a peer');
+    console.log('  grant           Update scope grants for a peer');
+    console.log('');
+    console.log('Examples:');
+    console.log('  ogp federation list');
+    console.log('  ogp federation request https://peer.example.com --alias big-papa');
+    console.log('  ogp federation approve <peer-id> --intents message,agent-comms');
+    console.log('  ogp federation send ?');
+    console.log('');
+}
+/**
+ * Federation send command help with available peers
+ */
+function showFederationSendHelp() {
+    console.log('\nSend a message to a federated peer');
+    console.log('');
+    console.log('Usage:');
+    console.log('  ogp federation send <peer-id> <intent> <payload>');
+    console.log('');
+    console.log('Arguments:');
+    console.log('  peer-id    Peer identifier (alias, ID, or public key)');
+    console.log('  intent     Intent name (e.g., message, custom-intent)');
+    console.log('  payload    JSON payload string');
+    console.log('');
+    // Show available peers
+    const peers = loadPeers();
+    const approvedPeers = peers.filter(p => p.status === 'approved');
+    if (approvedPeers.length > 0) {
+        console.log('Available peers:');
+        approvedPeers.forEach(peer => {
+            const identifier = peer.alias || peer.id;
+            const displayInfo = peer.alias ? `${peer.displayName} (${peer.id})` : peer.displayName;
+            console.log(`  ${identifier.padEnd(20)} ${displayInfo}`);
+        });
+        console.log('');
+    }
+    console.log('Examples:');
+    console.log('  ogp federation send big-papa message \'{"text":"Hello"}\'');
+    console.log('  ogp federation send <peer-id> custom-intent \'{"data":"value"}\'');
+    console.log('');
+}
+/**
+ * Federation agent command help with available peers
+ */
+function showFederationAgentHelp() {
+    console.log('\nSend an agent-comms message to a peer');
+    console.log('');
+    console.log('Usage:');
+    console.log('  ogp federation agent <peer-id> <topic> <message> [options]');
+    console.log('');
+    console.log('Arguments:');
+    console.log('  peer-id    Peer identifier (alias, ID, or public key)');
+    console.log('  topic      Topic for message routing (e.g., memory-management)');
+    console.log('  message    Message text content');
+    console.log('');
+    console.log('Options:');
+    console.log('  -p, --priority <level>      Priority (low|normal|high), default: normal');
+    console.log('  -c, --conversation <id>     Conversation ID for threading');
+    console.log('  -w, --wait                  Wait for reply');
+    console.log('  -t, --timeout <ms>          Reply timeout in milliseconds, default: 30000');
+    console.log('');
+    // Show available peers
+    const peers = loadPeers();
+    const approvedPeers = peers.filter(p => p.status === 'approved');
+    if (approvedPeers.length > 0) {
+        console.log('Available peers:');
+        approvedPeers.forEach(peer => {
+            const identifier = peer.alias || peer.id;
+            const displayInfo = peer.alias ? `${peer.displayName} (${peer.id})` : peer.displayName;
+            const topics = peer.responsePolicy?.topics ? Object.keys(peer.responsePolicy.topics).join(', ') : '-';
+            console.log(`  ${identifier.padEnd(20)} ${displayInfo}`);
+            if (topics !== '-') {
+                console.log(`    Topics: ${topics}`);
+            }
+        });
+        console.log('');
+    }
+    console.log('Examples:');
+    console.log('  ogp federation agent big-papa memory-management "Store this context"');
+    console.log('  ogp federation agent <peer-id> task-delegation "Create task X" -w');
+    console.log('');
+}
+/**
+ * Agent-comms configuration help
+ */
+function showAgentCommsHelp() {
+    console.log('\nAgent-comms policy management:');
+    console.log('  interview       Run the delegated-authority / human-delivery interview');
+    console.log('  policies        Show response policies (global and per-peer)');
+    console.log('  configure       Configure response policies for peers or globally');
+    console.log('  add-topic       Add a topic to a peer\'s response policy');
+    console.log('  set-topic       Set a topic policy for a peer (upsert)');
+    console.log('  set-default     Set per-peer default level');
+    console.log('  remove-topic    Remove a topic from a peer\'s response policy');
+    console.log('  reset           Reset a peer\'s policy to global defaults');
+    console.log('  activity        Show agent-comms activity log');
+    console.log('  default         Set global default response level');
+    console.log('  logging         Enable or disable activity logging');
+    console.log('');
+    console.log('Response levels:');
+    console.log('  full            Provide full context and detailed responses');
+    console.log('  summary         Provide summarized responses');
+    console.log('  escalate        Escalate to human for approval');
+    console.log('  deny            Deny the request');
+    console.log('  off             No response (silent)');
+    console.log('');
+    console.log('Examples:');
+    console.log('  ogp agent-comms interview');
+    console.log('  ogp agent-comms policies');
+    console.log('  ogp agent-comms configure --global --level summary');
+    console.log('  ogp agent-comms set-topic <peer-id> memory-management full');
+    console.log('  ogp agent-comms activity --last 20');
+    console.log('');
+}
+/**
+ * Config commands help
+ */
+function showConfigHelp() {
+    console.log('\nConfiguration management:');
+    console.log('  list            List all configured frameworks');
+    console.log('  add             Add a new framework');
+    console.log('  remove          Remove a framework');
+    console.log('  enable          Enable a framework');
+    console.log('  disable         Disable a framework');
+    console.log('  set-default     Set default framework');
+    console.log('  set-alias       Set an alias for a framework');
+    console.log('  show            Show configuration for a framework');
+    console.log('');
+    // Show current frameworks
+    try {
+        const metaConfig = loadMetaConfig();
+        if (metaConfig.frameworks && metaConfig.frameworks.length > 0) {
+            console.log('Configured frameworks:');
+            metaConfig.frameworks.forEach(f => {
+                const status = f.enabled ? '✓' : '✗';
+                const isDefault = metaConfig.default === f.id ? ' (default)' : '';
+                console.log(`  ${status} ${f.id.padEnd(20)} ${f.name}${isDefault}`);
+            });
+            console.log('');
+        }
+    }
+    catch (err) {
+        // Ignore if meta config not found
+    }
+    console.log('Examples:');
+    console.log('  ogp config list');
+    console.log('  ogp config add my-framework "My Framework" ~/.ogp-my-framework');
+    console.log('  ogp config set-default my-framework');
+    console.log('  ogp config set-alias mf my-framework');
+    console.log('');
+}
+/**
+ * Project commands help
+ */
+function showProjectHelp() {
+    console.log('\nProject collaboration commands:');
+    console.log('  create          Create a new project locally');
+    console.log('  join            Join an existing project');
+    console.log('  list            List all local projects');
+    console.log('  remove          Remove a local project');
+    console.log('  delete          Delete a project and all contributions');
+    console.log('  contribute      Add a contribution by entry type');
+    console.log('  query           Query project contributions');
+    console.log('  status          Show project status overview');
+    console.log('');
+    console.log('Federation commands:');
+    console.log('  request-join    Request to join a peer\'s project');
+    console.log('  send-contribution  Send a contribution to a peer');
+    console.log('  query-peer      Query a peer\'s project contributions');
+    console.log('  status-peer     Request project status from a peer');
+    console.log('');
+    console.log('Examples:');
+    console.log('  ogp project create my-project "My Project" --description "..."');
+    console.log('  ogp project contribute my-project task "Complete feature X"');
+    console.log('  ogp project query my-project --type decision --limit 10');
+    console.log('');
+}
+/**
+ * Intent registry help
+ */
+function showIntentHelp() {
+    console.log('\nIntent registry management:');
+    console.log('  register        Register a new intent handler');
+    console.log('  list            List all registered intents');
+    console.log('  remove          Remove a registered intent');
+    console.log('');
+    console.log('Examples:');
+    console.log('  ogp intent register my-intent --script ./handler.sh --description "..."');
+    console.log('  ogp intent list');
+    console.log('  ogp intent remove my-intent');
+    console.log('');
+}
+//# sourceMappingURL=help.js.map

package/dist/shared/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/shared/help.ts"],"names":[],"mappings":"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"}

package/dist/shared/meta-config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Framework configuration entry
+ */
+export interface Framework {
+    id: string;
+    name: string;
+    enabled: boolean;
+    configDir: string;
+    daemonPort: number;
+    gatewayUrl?: string;
+    displayName?: string;
+    platform?: string;
+}
+/**
+ * Meta configuration for managing multiple OGP framework installations
+ */
+export interface MetaConfig {
+    version: string;
+    frameworks: Framework[];
+    default?: string;
+    aliases?: Record<string, string>;
+}
+/**
+ * Get the path to the meta config file
+ */
+export declare function getMetaConfigPath(): string;
+/**
+ * Get the meta config directory path
+ */
+export declare function getMetaConfigDir(): string;
+/**
+ * Ensure the meta config directory exists
+ */
+export declare function ensureMetaConfigDir(): void;
+/**
+ * Load the meta configuration
+ * Returns sensible defaults if the file doesn't exist
+ */
+export declare function loadMetaConfig(): MetaConfig;
+/**
+ * Save the meta configuration
+ */
+export declare function saveMetaConfig(config: MetaConfig): void;
+//# sourceMappingURL=meta-config.d.ts.map

package/dist/shared/meta-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-config.d.ts","sourceRoot":"","sources":["../../src/shared/meta-config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,CA+C3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAYvD"}

package/dist/shared/meta-config.js

@@ -0,0 +1,89 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULT_META_CONFIG_DIR = path.join(os.homedir(), '.ogp-meta');
+const META_CONFIG_FILE = path.join(DEFAULT_META_CONFIG_DIR, 'config.json');
+/**
+ * Get the path to the meta config file
+ */
+export function getMetaConfigPath() {
+    return META_CONFIG_FILE;
+}
+/**
+ * Get the meta config directory path
+ */
+export function getMetaConfigDir() {
+    return DEFAULT_META_CONFIG_DIR;
+}
+/**
+ * Ensure the meta config directory exists
+ */
+export function ensureMetaConfigDir() {
+    if (!fs.existsSync(DEFAULT_META_CONFIG_DIR)) {
+        fs.mkdirSync(DEFAULT_META_CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Load the meta configuration
+ * Returns sensible defaults if the file doesn't exist
+ */
+export function loadMetaConfig() {
+    try {
+        if (!fs.existsSync(META_CONFIG_FILE)) {
+            // Return default configuration
+            return {
+                version: '1.0.0',
+                frameworks: [],
+            };
+        }
+        const data = fs.readFileSync(META_CONFIG_FILE, 'utf-8');
+        const config = JSON.parse(data);
+        // Validate schema
+        if (!config.version) {
+            throw new Error('Meta config missing required field: version');
+        }
+        if (!Array.isArray(config.frameworks)) {
+            throw new Error('Meta config missing or invalid field: frameworks');
+        }
+        // Validate each framework
+        for (const framework of config.frameworks) {
+            if (!framework.id || typeof framework.id !== 'string') {
+                throw new Error('Framework missing required field: id');
+            }
+            if (!framework.name || typeof framework.name !== 'string') {
+                throw new Error(`Framework ${framework.id} missing required field: name`);
+            }
+            if (typeof framework.enabled !== 'boolean') {
+                throw new Error(`Framework ${framework.id} missing required field: enabled`);
+            }
+            if (!framework.configDir || typeof framework.configDir !== 'string') {
+                throw new Error(`Framework ${framework.id} missing required field: configDir`);
+            }
+            if (typeof framework.daemonPort !== 'number') {
+                throw new Error(`Framework ${framework.id} missing required field: daemonPort`);
+            }
+        }
+        return config;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error(`Failed to parse meta config: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Save the meta configuration
+ */
+export function saveMetaConfig(config) {
+    ensureMetaConfigDir();
+    // Validate before saving
+    if (!config.version) {
+        throw new Error('Cannot save meta config: missing version');
+    }
+    if (!Array.isArray(config.frameworks)) {
+        throw new Error('Cannot save meta config: frameworks must be an array');
+    }
+    fs.writeFileSync(META_CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+//# sourceMappingURL=meta-config.js.map

package/dist/shared/meta-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-config.js","sourceRoot":"","sources":["../../src/shared/meta-config.ts"],"names":[],"mappings":"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"}