snipara-companion 3.2.2 → 3.2.4

package/README.md

@@ -56,6 +56,51 @@ These commands are useful without hosted Snipara:
 | `intelligence ledger-export`                                 | Structured redacted ledger JSON for replay and review        |
 | `stuck-guard`, `memory-guard`, `pre-tool`, `post-tool`       | Fail-soft local guards and hook helpers                      |
 
+### Local Worker Registry
+
+Use `workers local` when you want Companion to route bounded work to a local
+OpenAI-compatible runtime such as LM Studio. The registry is project state under
+`.snipara/workers/`; commit intentional profile changes like any other
+workflow artifact. Keep API keys, tokens, passwords, and private credentialed
+URLs out of worker profiles. Use environment variables for credentials.
+
+Probe the local runtime first:
+
+```bash
+npx -y snipara-companion workers local probe \
+  --base-url http://127.0.0.1:1234 \
+  --model openai/gpt-oss-20b \
+  --role documentation \
+  --capability docs_write \
+  --write-scope packages/cli/README.md
+```
+
+Declare the worker only after the probe matches the intended model and scope:
+
+```bash
+npx -y snipara-companion workers local add \
+  --id local-openai-gpt-oss-20b \
+  --base-url http://127.0.0.1:1234 \
+  --model openai/gpt-oss-20b \
+  --role documentation \
+  --capability docs_write \
+  --write-scope packages/cli/README.md
+```
+
+Inspect declared workers before routing:
+
+```bash
+npx -y snipara-companion workers local list
+npx -y snipara-companion workers local status --json
+```
+
+Remove stale local profiles when a model, endpoint, or write scope is no longer
+valid:
+
+```bash
+npx -y snipara-companion workers local remove local-openai-gpt-oss-20b
+```
+
 ## Agent Continuity
 
 After the first impact check, keep the work resumable:
@@ -71,6 +116,7 @@ npx -y snipara-companion workflow producer-triage
 npx -y snipara-companion workflow decisions
 npx -y snipara-companion workflow decide decision-abc123 --choose accept_all --reviewer alice
 npx -y snipara-companion workflow timeline
+npx -y snipara-companion workflow timeline --export md
 npx -y snipara-companion workflow session --json
 npx -y snipara-companion workflow producer-report
 npx -y snipara-companion workflow producer-review --latest --outcome useful --reviewer alice
@@ -84,8 +130,14 @@ verification hints.
 `workflow timeline` reads the append-only activity log at
 `.snipara/activity/timeline.jsonl`. `workflow session` derives
 `.snipara/activity/session.json` for fast local resume and Orchestrator dogfood;
-Session Snapshot V0 is observational and keeps `hardRoutingAllowed=false` until
-explicit routing policy and receipts exist.
+Session Snapshot V0 includes latest activity, risk reasons, touched files, a
+next action, and advisory Intent Detection V0. Intent Detection V0 reports the
+inferred intent, confidence, reason-code signals, local evidence counts, and a
+suggested workflow mode hint for the human or agent to consider. It is
+observational and keeps `hardRoutingAllowed=false` until explicit routing policy
+and receipts exist.
+`workflow timeline --export md` prints a compact redacted Markdown timeline for
+handoff or publication.
 
 Workflow `phase-commit` and `final-commit` also emit Producer Loop artifacts
 under `.snipara/producer-loop/`. These are local review evidence backed by the
@@ -116,7 +168,9 @@ Other producers such as `outcome-capture preview --emit-decisions`,
 paths declared; they do not write canonical memory directly. `memory reviews`
 is the hosted-memory review connector: it reads review queue, cleanup, and
 duplicate candidate surfaces, summarizes the items for the LLM, and only writes
-local Decision Requests when `--emit-decisions` is passed.
+local Decision Requests when `--emit-decisions` is passed. Its JSON output
+includes `emittedCount`, `emittedRequestIds`, and an `emitted` summary so an
+agent can continue without re-listing pending requests.
 
 ## Local First, Hosted When Useful
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ProjectRealityCheckResult, ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
+import { ProjectIntentDetectionResult, ProjectRealityCheckResult, ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
 
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
@@ -1563,6 +1563,16 @@ interface SessionSnapshot {
         handoffCount: number;
         latestHandoffAt?: string;
     };
+    summary: {
+        latestActivityAt?: string;
+        latestActivityTitle?: string;
+        latestActivityKind?: string;
+        risk: "none" | "watch" | "risk";
+        riskReasons: string[];
+        touchedFiles: string[];
+        recommendedNextAction: string;
+    };
+    intentDetection: ProjectIntentDetectionResult;
     routing: {
         hardRoutingAllowed: false;
         reason: string;
@@ -1600,6 +1610,7 @@ declare function writeSessionSnapshot(options?: {
     cwd?: string;
     limit?: number;
 }): SessionSnapshot;
+declare function readSessionSnapshot(cwd?: string): SessionSnapshot | null;
 
 type LocalCodeOverlayMode = "working_tree" | "local_commit";
 type LocalCodeOverlayKind = "none" | "local_commit" | "working_tree" | "mixed";
@@ -2017,6 +2028,7 @@ interface ProjectIntelligenceBrief {
     memoryHealth?: Record<string, unknown>;
     codeImpact?: Record<string, unknown>;
     codeImpactSourceSelection?: CodeGraphSourceSelection;
+    localSessionSnapshot?: SessionSnapshot;
     verificationPlan?: VerificationPlan;
     judgmentCard?: ProjectIntelligenceJudgmentCard;
     errors: Array<{
@@ -3538,9 +3550,11 @@ interface LocalWorkerDeclaration {
     endpointType: "local";
     provider: string;
     baseUrl: string;
+    command?: string;
     model?: string;
     preferModel?: string;
     capabilities: string[];
+    reasoning: "low" | "medium" | "high";
     writeScope: string[];
     createdAt: string;
     updatedAt: string;
@@ -3572,14 +3586,41 @@ interface LocalWorkerAddOptions {
     preferModel?: string;
     capabilities?: string[];
     writeScope?: string[];
+    contextWindow?: number;
+    reasoning?: "low" | "medium" | "high";
     default?: boolean;
     json?: boolean;
+    transport?: "openai_http" | "cli";
+    command?: string;
 }
 interface LocalWorkerStatusOptions {
     json?: boolean;
 }
+interface LocalWorkerListOptions {
+    json?: boolean;
+}
+interface LocalWorkerRemoveOptions {
+    id: string;
+    json?: boolean;
+}
+interface LocalWorkerProbeOptions {
+    baseUrl?: string;
+    provider?: string;
+    model?: string;
+    preferModel?: string;
+    role?: string;
+    workerId?: string;
+    capabilities?: string[];
+    writeScope?: string[];
+    reasoning?: "low" | "medium" | "high";
+    contextWindow?: number;
+    json?: boolean;
+}
 declare function workersLocalAddCommand(options: LocalWorkerAddOptions): void;
 declare function workersLocalStatusCommand(options?: LocalWorkerStatusOptions): void;
+declare function workersLocalListCommand(options?: LocalWorkerListOptions): void;
+declare function workersLocalRemoveCommand(options: LocalWorkerRemoveOptions): void;
+declare function workersLocalProbePrintCommand(options: LocalWorkerProbeOptions): void;
 declare function addLocalWorker(options: LocalWorkerAddOptions): {
     worker: LocalWorkerDeclaration;
     config: LocalWorkersConfig;
@@ -4065,6 +4106,7 @@ interface AdaptiveRoutingCard {
     costEstimate: AdaptiveRoutingCostEstimate;
     humanApprovalRequired: boolean;
     fallback: "main_agent";
+    rejectedReasons?: Record<string, string[]>;
     reasons: string[];
     warnings: string[];
 }
@@ -4096,6 +4138,7 @@ interface AdaptiveRoutingResolution {
     fallback?: string;
     reasons?: string[];
     warnings?: string[];
+    rejectedReasons?: Record<string, string[]>;
 }
 interface AdaptiveWorkRoutingRecommendation {
     workProfile: AdaptiveWorkProfile;
@@ -4212,4 +4255,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };