fieldcure-assiststudio-runner: Instructions file for Claude Code

FieldCure AssistStudio Runner

Windows-only headless LLM task automation engine — define natural language tasks, schedule them via Windows Task Scheduler, and dispatch results through the AssistStudio Outbox channels (Slack, Telegram, Email, KakaoTalk, Discord). Runs as an MCP server in serve mode for task CRUD and as a one-shot CLI in exec mode for headless execution.

Distributed as a single dotnet tool NuGet package (FieldCure.AssistStudio.Runner).

Solution structure

FieldCure.AssistStudio.Runner.slnx       ← .slnx format (requires VS 17.12+)
src/
└── FieldCure.AssistStudio.Runner/       → NuGet: FieldCure.AssistStudio.Runner
    │                                      (net8.0, [SupportedOSPlatform("windows")])
    │                                      PackAsTool=true, ToolCommandName=assiststudio-runner
    │                                      PackageType=McpServer (.mcp/server.json)
    │
    ├── Program.cs                       Entry point — dispatches `serve` / `exec` /
    │                                    `config` subcommands.
    ├── Configuration/ConfigRunner.cs    `config init / set-credential / get-credential` CLI.
    ├── Credentials/                     PasswordVault adapter (Windows Credential Manager).
    │   ├── ICredentialService           GetApiKey / SetApiKey + GetMcpEnvVar / SetMcpEnvVar.
    │   └── CredentialService            Single-user CredWrite/CredRead implementation.
    ├── Execution/
    │   ├── TaskExecutor                 Task → AgentLoop run, streams ExecutionLog rounds.
    │   └── McpServerPool                Bootstraps task-scoped MCP servers + tool allowlist.
    ├── Models/
    │   ├── RunnerConfig                 Global runner.json shape: DefaultModelName, Models
    │   │                                (Dictionary<string, ModelConfig>), DefaultMcpServers,
    │   │                                Retry, FallbackChannel, …
    │   ├── RunnerTask                   Task DB row: prompt, schedule, ModelName, Guardrails,
    │   │                                McpServers, OutputChannel.
    │   ├── TaskExecution                Per-run execution record with status + summary.
    │   ├── ExecutionLog                 Round-by-round trace for audit (Messages array).
    │   ├── ExecutionStatus              Pending / Running / Succeeded / Failed / Cancelled / TimedOut.
    │   └── McpServerConfig              Task-level MCP server entry (id/name/command/args/env-keys).
    ├── Scheduling/
    │   ├── IJobScheduler                Abstraction so future non-Windows backends can plug in.
    │   ├── WindowsTaskScheduler         Default implementation — schtasks shell-out.
    │   ├── SchtasksTrigger              Encodes a schedule as schtasks command-line arguments.
    │   └── CronToSchtasks               Cron expression → schtasks subset (5-field standard cron).
    ├── Storage/TaskStore.cs             SQLite (`runner.db`) — Tasks + TaskExecutions tables,
    │                                    inline ALTER TABLE migrations on Initialize().
    ├── Tools/                           MCP tool implementations (one per file).
    │   ├── CreateTaskTool / UpdateTaskTool / DeleteTaskTool
    │   ├── ListTasksTool / GetTaskHistoryTool / GetExecutionStatusTool
    │   └── RunTaskTool                  Triggers a task and optionally waits up to 60s.
    ├── .mcp/server.json                 MCP registry metadata (mirrors csproj <Version>).
    ├── README.md                        NuGet-shipped package README.
    └── Logo.png                         Package icon.

tests/
└── FieldCure.AssistStudio.Runner.Tests/  RunnerConfigTests + others (MSTest).

scripts/publish-nuget.ps1                Pack → sign (GlobalSign EV USB dongle) → push.