Chaim
ab5d34a9d3
תוצר analyze_protocol (איך הטענות הכתובות התפתחו בדיון בעל-פה) היה שכבת ידע-תיק ללא endpoint ותצוגה — נצרך רק downstream ע"י הכותב בבלוק-י. פאנל חדש בתחתית טאב "טיעונים ועמדות", מתחת לכרטיס-הטיעונים (INV-IA1: לא טאב-מקביל). Backend: - SCHEMA_V51: cases.hearing_attendees JSONB — בית קנוני לנוכחות-בדיון (panel_members/appellants_present/respondents_present). נבדל סמנטית מ-decisions.panel_members (מותב חותם-ההחלטה) → אין מסלול-מקביל (G2). - protocol_analyzer._extract_header: מאכלס hearing_attendees; refresh על re-run (מתקן #223), לא דורס עם חילוץ ריק. אישור-משתמש: "אפשרות א" (persist+הצגה). - GET /api/cases/{n}/protocol-analysis — header (תאריך+נוכחים קנוניים) + verdicts מקובצים לפי צד. קריאה-בלבד, container-safe, ריק≠שגיאה. - POST /api/cases/{n}/analyze-protocol — מעיר את המנתח (analyze_protocol מריץ claude מקומי, נעדר בקונטיינר) כתבנית aggregate-arguments. - מגע-Paperclip רק דרך agent_platform_port (G12): wake_analyst_for_protocol_analysis. Frontend: - lib/api/protocol-analysis.ts (hooks read+trigger) + HearingChangesPanel (סרגל-כותרת, פסי-סינון התחזק/נטען-לראשונה, כרטיסים לפי צד, ציטוט-ראיה). - חיווט לטאב arguments מתחת ל-LegalArgumentsPanel. עיצוב: מוקאפ 27-case-hearing-changes-panel אושר ע"י חיים דרך שער Claude Design (X17). Invariants: מקיים G2 (בית קנוני יחיד, לא מסלול-מקביל), G1 (נרמול-במקור), G12 (שער-הפלטפורמה), INV-IA1 (לא טאב-מקביל), INV-AH (evidence_quote כבר נאכף במקור). אימות: py_compile + tsc --noEmit + eslint ירוקים; runtime של ה-endpoint = post-deploy. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
128 lines
5.1 KiB
Python
128 lines
5.1 KiB
Python
"""Agent Platform Port (INV-G12 / docs/spec/X15) — the single seam to the platform.
|
|
|
|
Paperclip is the *agent platform*: a replaceable shell, not the core. This module
|
|
is the ONLY place in the web layer that may import the Paperclip client
|
|
(``web.paperclip_client`` / ``web.paperclip_api``). ``web/app.py`` — and any future
|
|
web code — imports the platform operations from HERE, never from the Paperclip
|
|
modules directly. So the dependency points inward (Ports & Adapters / the
|
|
Dependency Rule, Cockburn / Martin): swapping the platform means re-implementing
|
|
this one module, not touching app.py.
|
|
|
|
Enforced by the leak-guard (X15 §4 / R4): no file outside this Port imports
|
|
``paperclip_client`` / ``paperclip_api``.
|
|
|
|
Two tiers:
|
|
• **Lifecycle side-effects** — archive / restore / create a case's project, and
|
|
the case-status notification — are also exposed under domain names
|
|
(``archive_case_project`` …). These are the genuine domain events the app
|
|
emits over a case's lifecycle; prefer them in new code.
|
|
• **Issue / interaction / comment / agent operations** are re-exported under
|
|
their existing ``pc_*`` names: they are request/response API calls, not
|
|
events, so a faithful facade re-export — rather than an artificial "event" —
|
|
is the honest treatment. Migrating these to domain verbs is a follow-up that
|
|
can happen as call sites are touched; the import seam (the enforceable part
|
|
of G12) holds regardless.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
# ── the Paperclip shell — imported ONLY here (the Port is the single seam) ──
|
|
from web.paperclip_api import (
|
|
emit_case_status_webhook,
|
|
emit_export_complete_webhook,
|
|
emit_missing_precedent_webhook,
|
|
pc_request,
|
|
require_paperclip_db_url,
|
|
)
|
|
from web.paperclip_client import (
|
|
COMPANIES as PAPERCLIP_COMPANIES,
|
|
accept_interaction as pc_accept_interaction,
|
|
archive_project as pc_archive_project,
|
|
cancel_interaction as pc_cancel_interaction,
|
|
cancel_run as pc_cancel_run,
|
|
create_project as pc_create_project,
|
|
create_workflow_issue as pc_create_workflow_issue,
|
|
get_agents_for_case as pc_get_agents_for_case,
|
|
get_agents_for_company as pc_get_agents,
|
|
get_case_issues as pc_get_case_issues,
|
|
get_issue_comments as pc_get_issue_comments,
|
|
get_issue_interactions as pc_get_issue_interactions,
|
|
get_project_url,
|
|
get_run_events as pc_get_run_events,
|
|
get_run_log as pc_get_run_log,
|
|
list_live_runs as pc_list_live_runs,
|
|
post_comment as pc_post_comment,
|
|
reap_stale_interactions as pc_reap_stale_interactions,
|
|
reject_interaction as pc_reject_interaction,
|
|
reset_agent_session as pc_reset_agent_session,
|
|
reset_case_agents as pc_reset_case_agents,
|
|
respond_to_interaction as pc_respond_to_interaction,
|
|
restore_project as pc_restore_project,
|
|
update_project_name as pc_update_project_name,
|
|
wake_analyst_for_appraiser_facts as pc_wake_analyst_for_appraiser_facts,
|
|
wake_analyst_for_argument_aggregation as pc_wake_analyst_for_argument_aggregation,
|
|
wake_analyst_for_protocol_analysis as pc_wake_analyst_for_protocol_analysis,
|
|
wake_ceo_agent as pc_wake_ceo,
|
|
wake_ceo_for_action as pc_wake_ceo_for_action,
|
|
wake_ceo_for_feedback_fold as pc_wake_ceo_for_feedback_fold,
|
|
wake_curator_for_final as pc_wake_curator_for_final,
|
|
wake_for_precedent_extraction as pc_wake_for_precedent_extraction,
|
|
)
|
|
|
|
# ── domain-named lifecycle aliases (preferred for new call sites) ───────────
|
|
archive_case_project = pc_archive_project
|
|
restore_case_project = pc_restore_project
|
|
create_case_project = pc_create_project
|
|
rename_case_project = pc_update_project_name
|
|
notify_case_status = emit_case_status_webhook
|
|
|
|
__all__ = [
|
|
# platform infrastructure
|
|
"PAPERCLIP_COMPANIES",
|
|
"pc_request",
|
|
"require_paperclip_db_url",
|
|
"get_project_url",
|
|
# lifecycle — domain names (preferred) + legacy aliases
|
|
"archive_case_project",
|
|
"restore_case_project",
|
|
"create_case_project",
|
|
"rename_case_project",
|
|
"notify_case_status",
|
|
"emit_case_status_webhook",
|
|
"emit_export_complete_webhook",
|
|
"emit_missing_precedent_webhook",
|
|
"pc_archive_project",
|
|
"pc_restore_project",
|
|
"pc_create_project",
|
|
"pc_update_project_name",
|
|
# issues / workflow
|
|
"pc_create_workflow_issue",
|
|
"pc_get_case_issues",
|
|
# agents / wakeups
|
|
"pc_get_agents_for_case",
|
|
"pc_get_agents",
|
|
"pc_wake_ceo",
|
|
"pc_wake_ceo_for_action",
|
|
"pc_wake_ceo_for_feedback_fold",
|
|
"pc_wake_curator_for_final",
|
|
"pc_wake_for_precedent_extraction",
|
|
"pc_wake_analyst_for_appraiser_facts",
|
|
"pc_wake_analyst_for_argument_aggregation",
|
|
"pc_wake_analyst_for_protocol_analysis",
|
|
# comments / interactions
|
|
"pc_post_comment",
|
|
"pc_get_issue_comments",
|
|
"pc_get_issue_interactions",
|
|
"pc_accept_interaction",
|
|
"pc_reject_interaction",
|
|
"pc_respond_to_interaction",
|
|
"pc_cancel_interaction",
|
|
"pc_reap_stale_interactions",
|
|
# agent-run observability + control (live view + smart management)
|
|
"pc_list_live_runs",
|
|
"pc_get_run_log",
|
|
"pc_get_run_events",
|
|
"pc_cancel_run",
|
|
"pc_reset_agent_session",
|
|
"pc_reset_case_agents",
|
|
]
|