@my-life-buddies/buddy-creator-skill 1.6.0

package/scripts/buddy.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Run Buddy Creator Skill using only the Python standard library."""
+import argparse
+import json
+import os
+import re
+import sys
+from pathlib import Path
+
+if sys.version_info < (3, 9):
+    print(json.dumps({'ok': False, 'error': {'code': 'PYTHON_VERSION', 'message': '需要 Python 3.9 或更高版本；无需 Node、npm 或 pip。'}}, ensure_ascii=False))
+    sys.exit(1)
+if hasattr(sys.stdout, 'reconfigure'):
+    sys.stdout.reconfigure(encoding='utf-8')
+if hasattr(sys.stderr, 'reconfigure'):
+    sys.stderr.reconfigure(encoding='utf-8')
+
+import buddy_core as core
+
+
+def parse_input(path):
+    if path == '-' and sys.stdin.isatty():
+        raise core.BuddyError('INPUT_TTY', '请求 JSON 不接受交互式 TTY 输入；请用 --input <UTF-8 JSON文件>，或通过非 TTY 管道提交 --input -。无需发送 Ctrl-D。')
+    try:
+        raw = sys.stdin.read() if path == '-' else Path(path).expanduser().read_text(encoding='utf-8')
+        return json.loads(raw)
+    except json.JSONDecodeError as error:
+        raise core.BuddyError('INPUT_JSON', '请求 JSON 格式无效。', {'line': error.lineno, 'column': error.colno}) from error
+    except (OSError, ValueError) as error:
+        raise core.BuddyError('INPUT_JSON', '无法读取请求 JSON；--input 使用 UTF-8 文件路径或 - 表示标准输入。') from error
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Buddy Creator Skill：宿主采访、Python 本地保存与只读预览。')
+    parser.add_argument('--version', action='version', version=core.METADATA['displayName'] + ' ' + core.METADATA['version'])
+    sub = parser.add_subparsers(dest='command', required=True)
+    opened = sub.add_parser('open', help='创建或恢复 Buddy 项目')
+    opened.add_argument('--creation-key')
+    opened.add_argument('--workspace')
+    opened.add_argument('--context', help='可选的初始背景 JSON 文件；不是采访回答或确认')
+    opened.add_argument('--no-browser', action='store_true', help='由宿主打开预览，不调用系统浏览器（默认行为）')
+    call = sub.add_parser('call', help='提交协议请求')
+    call.add_argument('--workspace', required=True)
+    call.add_argument('--input', default='-')
+    panel = sub.add_parser('preview-panel', help='记录宿主观察到的面板状态与一次性重开提醒；不改变采访进度')
+    panel.add_argument('--workspace', required=True)
+    panel.add_argument('--input', default='-', help='包含 action 的 JSON 文件或非 TTY 标准输入')
+    for name in ['serve', 'status']:
+        command = sub.add_parser(name)
+        command.add_argument('--workspace', required=True)
+    args = parser.parse_args()
+    if args.command == 'serve':
+        import preview
+        preview.serve(Path(args.workspace).expanduser().resolve())
+        return
+    if args.command == 'open':
+        initial_context = parse_input(args.context) if args.context else None
+        if args.context and initial_context is None:
+            raise core.BuddyError('INITIAL_CONTEXT_SCHEMA', '初始背景必须为 JSON 对象，不能为 null。')
+        workspace, state = core.open_workspace(args.creation_key, args.workspace, initial_context)
+        import preview
+        try:
+            endpoint = preview.start(workspace)
+        except Exception as error:
+            endpoint = {'status': 'unavailable', 'message': str(error), 'recovery': '项目已经保存。允许本地端口后重试同一 open；不要更换 creation-key。'}
+        directive = 'continue_turn' if state.get('pendingTurnId') else ('prepare_opening' if core.needs_opening(state) else 'present_delivery')
+        result = {'workspace': str(workspace), 'buddyId': state['buddyId'], 'preview': endpoint, 'delivery': None if directive == 'prepare_opening' else state['deliveries'].get(state.get('currentDeliveryId')), 'directive': directive, 'context': core.context(workspace, state), 'entrypointCommand': {'executable': sys.executable, 'args': [str(Path(__file__).resolve())]}}
+    elif args.command == 'status':
+        workspace = Path(args.workspace).expanduser().resolve()
+        with core.workspace_lock(workspace):
+            state = core.load(workspace)
+        import preview
+        result = {'workspace': str(workspace), 'context': core.context(workspace, state), 'snapshot': preview.snapshot(workspace, state)}
+    elif args.command == 'preview-panel':
+        import preview_panel
+        result = preview_panel.call(args.workspace, parse_input(args.input))
+    else:
+        result = core.call(args.workspace, parse_input(args.input))
+    if args.command in ('open', 'status'):
+        import completion
+        completion.return_to_caller(workspace, state, result)
+    print(json.dumps(dict(ok=True, product=core.METADATA['displayName'], version=core.METADATA['version'], **result), ensure_ascii=False, indent=2, allow_nan=False), flush=True)
+
+
+def cli():
+    try:
+        try:
+            main()
+            return 0
+        except core.BuddyError as error:
+            print(json.dumps({'ok': False, 'error': {'code': error.code, 'message': str(error), 'details': error.details}}, ensure_ascii=False, indent=2), flush=True)
+        except BrokenPipeError:
+            raise
+        except Exception as error:
+            match = re.match(r'^([A-Z][A-Z0-9_]+):\s*(.*)', str(error), re.DOTALL)
+            code, message = match.groups() if match else ('UNEXPECTED_ERROR', str(error))
+            print(json.dumps({'ok': False, 'error': {'code': code, 'message': message, 'recovery': '已提交的原话和历史版本仍保留。读取 status 或 turn_continue 恢复，勿创建重复项目。'}}, ensure_ascii=False, indent=2), flush=True)
+        return 1
+    except BrokenPipeError:
+        # Prevent a second failure when Python flushes stdout during shutdown.
+        with open(os.devnull, 'w') as sink:
+            os.dup2(sink.fileno(), sys.stdout.fileno())
+        print(json.dumps({'error': {'code': 'OUTPUT_CLOSED', 'message': '回执输出管道已关闭，操作可能已经保存。请先读取 status 或 turn_continue 核对结果；不要创建新回合重复提交。'}}, ensure_ascii=False), file=sys.stderr, flush=True)
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(cli())

package/scripts/buddy_client.py

@@ -0,0 +1,67 @@
+"""A workspace-bound, stdlib-only client for host-authored Creator requests."""
+import json
+import os
+from pathlib import Path
+import subprocess
+import sys
+
+from buddy_core import BuddyError
+
+
+class BuddyClient:
+    def __init__(self, workspace, python=None, timeout=60):
+        self.workspace = str(Path(workspace).expanduser().resolve())
+        self.command = [python or sys.executable, '-B', str(Path(__file__).with_name('buddy.py'))]
+        self.timeout = timeout
+        self.context = None
+
+    def _run(self, command, payload=None):
+        args = self.command + [command, '--workspace', self.workspace]
+        raw = None
+        if payload is not None:
+            args += ['--input', '-']
+            raw = json.dumps(payload, ensure_ascii=False, allow_nan=False)
+        try:
+            process = subprocess.run(args, input=raw, stdin=subprocess.DEVNULL if raw is None else None,
+                                     capture_output=True, encoding='utf-8', timeout=self.timeout,
+                                     env={**os.environ, 'PYTHONDONTWRITEBYTECODE': '1'})
+        except (OSError, subprocess.TimeoutExpired) as error:
+            raise BuddyError('CLIENT_TRANSPORT', '未取得 Creator 回执；先用 status 或 turn_continue 核对结果，不自动重试写入。') from error
+        try:
+            result = json.loads(process.stdout)
+        except ValueError as error:
+            raise BuddyError('CLIENT_RESPONSE', 'Creator 回执不是完整 JSON；先核对已保存状态，不创建新回合重试。',
+                             {'exitCode': process.returncode}) from error
+        if isinstance(result, dict) and result.get('ok') is False and isinstance(result.get('error'), dict):
+            error = result['error']
+            raise BuddyError(error['code'], error['message'], error.get('details'))
+        if process.returncode or not isinstance(result, dict) or result.get('ok') is not True:
+            raise BuddyError('CLIENT_RESPONSE', 'Creator 未返回成功回执；先核对已保存状态。', {'exitCode': process.returncode})
+        if 'context' in result:
+            self.context = result['context']
+        return result
+
+    def status(self):
+        return self._run('status')
+
+    def call(self, payload):
+        # No automatic retries: the host retains the exact clientKey/turnId and payload.
+        return self._run('call', payload)
+
+    def _object(self, collection, object_id):
+        if self.context is None:
+            raise BuddyError('CLIENT_CONTEXT', '先调用 status 或保存本轮输入，再从返回的版本生成引用。')
+        item = self.context['state'][collection].get(object_id)
+        if item is None:
+            raise BuddyError('CLIENT_REFERENCE', '当前回执中没有此对象，请核对 ID。', {'id': object_id})
+        return item
+
+    def artifact_ref(self, object_id):
+        item = self._object('artifacts', object_id)
+        return {'type': 'artifact', 'id': object_id, 'hash': item['hash']}
+
+    def input_ref(self, input_id, quote):
+        item = self._object('inputs', input_id)
+        if not isinstance(quote, str) or not quote.strip() or quote not in item['raw']:
+            raise BuddyError('EVIDENCE_QUOTE', '引用必须是该输入中的非空精确原话。', {'id': input_id})
+        return {'type': 'input', 'id': input_id, 'hash': item['hash'], 'quote': quote}