snipara-companion 3.0.1 → 3.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +261 -179
- package/dist/index.js +1388 -824
- package/docs/FULL_REFERENCE.md +32 -2
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -2161,6 +2161,8 @@ declare const ENGINEERING_LEAD_WORK_PACKAGE_STATUSES: readonly ["contracting", "
|
|
|
2161
2161
|
declare const ENGINEERING_LEAD_SUPERVISION_STATUSES: readonly ["on_track", "needs_review", "needs_replan", "blocked", "cold_start", "unknown"];
|
|
2162
2162
|
declare const ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES: readonly ["pending_handoff", "handoff_ready", "executing", "verification_required", "blocked", "closed", "unknown"];
|
|
2163
2163
|
declare const ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES: readonly ["handoff", "claim", "approval", "proof", "outcome", "brain_update"];
|
|
2164
|
+
declare const ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES: readonly ["declared", "provided", "verified", "rejected", "unknown"];
|
|
2165
|
+
declare const ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES: readonly ["agent_report", "companion_handoff", "local_command", "ci", "htask", "manual", "unknown"];
|
|
2164
2166
|
type EngineeringLeadPlanSummary = ProjectIntelligenceEngineeringLeadPlanSummary;
|
|
2165
2167
|
interface CompanionEngineeringLeadReconciliation {
|
|
2166
2168
|
status: "on_track" | "needs_review" | "needs_replan" | "blocked";
|
|
@@ -2353,6 +2355,203 @@ interface ProjectIntelligenceRunResult {
|
|
|
2353
2355
|
declare function buildProjectIntelligenceRun(options: ProjectRunCommandOptions): Promise<ProjectIntelligenceRunResult>;
|
|
2354
2356
|
declare function projectIntelligenceRunCommand(options: ProjectRunCommandOptions): Promise<void>;
|
|
2355
2357
|
|
|
2358
|
+
declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
|
|
2359
|
+
type TeamSyncAttention = "note" | "watch" | "review" | "proof";
|
|
2360
|
+
type TeamSyncWorkStatus = "active" | "completed" | "archived";
|
|
2361
|
+
interface TeamSyncRecordInput {
|
|
2362
|
+
summary: string;
|
|
2363
|
+
files?: string[];
|
|
2364
|
+
branch?: string;
|
|
2365
|
+
actor?: string;
|
|
2366
|
+
next?: string;
|
|
2367
|
+
attention?: string;
|
|
2368
|
+
risk?: string;
|
|
2369
|
+
now?: Date;
|
|
2370
|
+
}
|
|
2371
|
+
interface TeamSyncWorkRecord {
|
|
2372
|
+
id: string;
|
|
2373
|
+
type: "work";
|
|
2374
|
+
summary: string;
|
|
2375
|
+
files: string[];
|
|
2376
|
+
branch?: string;
|
|
2377
|
+
actor?: string;
|
|
2378
|
+
status: TeamSyncWorkStatus;
|
|
2379
|
+
createdAt: string;
|
|
2380
|
+
updatedAt: string;
|
|
2381
|
+
completedAt?: string;
|
|
2382
|
+
completionReason?: string;
|
|
2383
|
+
archivedAt?: string;
|
|
2384
|
+
archiveReason?: string;
|
|
2385
|
+
}
|
|
2386
|
+
interface TeamSyncHandoffRecord {
|
|
2387
|
+
id: string;
|
|
2388
|
+
type: "handoff";
|
|
2389
|
+
summary: string;
|
|
2390
|
+
files: string[];
|
|
2391
|
+
next?: string;
|
|
2392
|
+
attention?: TeamSyncAttention;
|
|
2393
|
+
actor?: string;
|
|
2394
|
+
createdAt: string;
|
|
2395
|
+
}
|
|
2396
|
+
interface TeamSyncState {
|
|
2397
|
+
schemaVersion: "snipara.team-sync.v1";
|
|
2398
|
+
updatedAt: string;
|
|
2399
|
+
work: TeamSyncWorkRecord[];
|
|
2400
|
+
handoffs: TeamSyncHandoffRecord[];
|
|
2401
|
+
}
|
|
2402
|
+
interface TeamSyncSummary {
|
|
2403
|
+
activeWorkCount: number;
|
|
2404
|
+
staleWorkCount: number;
|
|
2405
|
+
completedWorkCount: number;
|
|
2406
|
+
archivedWorkCount: number;
|
|
2407
|
+
handoffCount: number;
|
|
2408
|
+
files: string[];
|
|
2409
|
+
staleWorkExplanation: TeamSyncStaleWorkExplanation;
|
|
2410
|
+
latestActiveWork?: TeamSyncWorkRecord;
|
|
2411
|
+
latestStaleWork?: TeamSyncWorkRecord;
|
|
2412
|
+
latestCompletedWork?: TeamSyncWorkRecord;
|
|
2413
|
+
latestArchivedWork?: TeamSyncWorkRecord;
|
|
2414
|
+
latestHandoff?: TeamSyncHandoffRecord;
|
|
2415
|
+
}
|
|
2416
|
+
interface TeamSyncStaleWorkExplanation {
|
|
2417
|
+
staleAfterHours: number;
|
|
2418
|
+
autoArchiveAfterDays: number;
|
|
2419
|
+
activeStaleCount: number;
|
|
2420
|
+
autoArchivableCount: number;
|
|
2421
|
+
completedIgnoredCount: number;
|
|
2422
|
+
archivedIgnoredCount: number;
|
|
2423
|
+
latestStaleWorkAgeHours?: number;
|
|
2424
|
+
message: string;
|
|
2425
|
+
}
|
|
2426
|
+
interface TeamSyncCommandOptions {
|
|
2427
|
+
id?: string;
|
|
2428
|
+
summary?: string;
|
|
2429
|
+
files?: string[];
|
|
2430
|
+
branch?: string;
|
|
2431
|
+
actor?: string;
|
|
2432
|
+
next?: string;
|
|
2433
|
+
attention?: string;
|
|
2434
|
+
risk?: string;
|
|
2435
|
+
adapterPack?: boolean;
|
|
2436
|
+
adapterTarget?: string;
|
|
2437
|
+
context?: string[];
|
|
2438
|
+
proof?: string[];
|
|
2439
|
+
acceptance?: string[];
|
|
2440
|
+
conflictPosture?: string;
|
|
2441
|
+
since?: string;
|
|
2442
|
+
dir?: string;
|
|
2443
|
+
includeSessionContext?: boolean;
|
|
2444
|
+
emitOrchestratorHandoff?: boolean;
|
|
2445
|
+
autoRouteOrchestrator?: boolean;
|
|
2446
|
+
orchestratorPolicySource?: string;
|
|
2447
|
+
output?: string;
|
|
2448
|
+
days?: string;
|
|
2449
|
+
dryRun?: boolean;
|
|
2450
|
+
json?: boolean;
|
|
2451
|
+
}
|
|
2452
|
+
interface HostedAttempt<T> {
|
|
2453
|
+
status: "skipped" | "ok" | "error";
|
|
2454
|
+
data?: T;
|
|
2455
|
+
error?: string;
|
|
2456
|
+
}
|
|
2457
|
+
interface TeamSyncSweepResult {
|
|
2458
|
+
action: "sweep";
|
|
2459
|
+
statePath: string;
|
|
2460
|
+
dryRun: boolean;
|
|
2461
|
+
thresholdDays: number;
|
|
2462
|
+
thresholdMs: number;
|
|
2463
|
+
archivedCount: number;
|
|
2464
|
+
archivedWork: TeamSyncWorkRecord[];
|
|
2465
|
+
explanation: TeamSyncSweepExplanation;
|
|
2466
|
+
summary: TeamSyncSummary;
|
|
2467
|
+
}
|
|
2468
|
+
interface TeamSyncSweepExplanation {
|
|
2469
|
+
mode: "preview" | "archive";
|
|
2470
|
+
candidateCount: number;
|
|
2471
|
+
archivedCount: number;
|
|
2472
|
+
remainingStaleCount: number;
|
|
2473
|
+
message: string;
|
|
2474
|
+
}
|
|
2475
|
+
type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
|
|
2476
|
+
type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
|
|
2477
|
+
interface AgenticHandoffAdapterPack {
|
|
2478
|
+
version: "snipara.ade_adapter_pack.v1";
|
|
2479
|
+
target: {
|
|
2480
|
+
id: AgenticHandoffAdapterTarget;
|
|
2481
|
+
label: string;
|
|
2482
|
+
instruction: string;
|
|
2483
|
+
};
|
|
2484
|
+
contextPack: {
|
|
2485
|
+
summary: string;
|
|
2486
|
+
files: string[];
|
|
2487
|
+
contextRefs: string[];
|
|
2488
|
+
workflow?: {
|
|
2489
|
+
goal?: string;
|
|
2490
|
+
status?: string;
|
|
2491
|
+
currentPhaseId?: string;
|
|
2492
|
+
currentPhaseTitle?: string;
|
|
2493
|
+
};
|
|
2494
|
+
resumeCommands: string[];
|
|
2495
|
+
constraints: string[];
|
|
2496
|
+
};
|
|
2497
|
+
conflictPosture: AgenticHandoffConflictPosture;
|
|
2498
|
+
proofGates: string[];
|
|
2499
|
+
acceptanceCriteria: string[];
|
|
2500
|
+
receiptExpectation: {
|
|
2501
|
+
required: boolean;
|
|
2502
|
+
command: string;
|
|
2503
|
+
requiredFields: string[];
|
|
2504
|
+
};
|
|
2505
|
+
prompt: string;
|
|
2506
|
+
caveats: string[];
|
|
2507
|
+
}
|
|
2508
|
+
interface TeamSyncCompletionEvidenceOptions {
|
|
2509
|
+
summary?: string;
|
|
2510
|
+
workflowGoal?: string;
|
|
2511
|
+
files?: string[];
|
|
2512
|
+
reason?: string;
|
|
2513
|
+
now?: Date;
|
|
2514
|
+
dryRun?: boolean;
|
|
2515
|
+
}
|
|
2516
|
+
interface AgenticHandoffArtifact {
|
|
2517
|
+
version: "snipara.agentic_handoff.v1";
|
|
2518
|
+
generatedAt: string;
|
|
2519
|
+
command: "snipara-companion handoff";
|
|
2520
|
+
record: TeamSyncHandoffRecord;
|
|
2521
|
+
statePath: string;
|
|
2522
|
+
hosted: {
|
|
2523
|
+
status: HostedAttempt<TeamSyncHandoffResponse>["status"];
|
|
2524
|
+
handoffId?: string;
|
|
2525
|
+
error?: string;
|
|
2526
|
+
};
|
|
2527
|
+
sections: {
|
|
2528
|
+
whatChanged: string[];
|
|
2529
|
+
verified: string[];
|
|
2530
|
+
risky: string[];
|
|
2531
|
+
remains: string[];
|
|
2532
|
+
whereToResume: string[];
|
|
2533
|
+
};
|
|
2534
|
+
suggestedCommands: string[];
|
|
2535
|
+
adapter?: AgenticHandoffAdapterPack;
|
|
2536
|
+
}
|
|
2537
|
+
declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
|
|
2538
|
+
declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
|
|
2539
|
+
declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
|
|
2540
|
+
declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
|
|
2541
|
+
declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
|
|
2542
|
+
now?: Date;
|
|
2543
|
+
thresholdMs?: number;
|
|
2544
|
+
dryRun?: boolean;
|
|
2545
|
+
}): TeamSyncSweepResult["archivedWork"];
|
|
2546
|
+
declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
2547
|
+
declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
2548
|
+
declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
|
|
2549
|
+
declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
|
|
2550
|
+
declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
|
|
2551
|
+
declare function getTeamSyncStatePath(rootDir?: string): string;
|
|
2552
|
+
declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
|
|
2553
|
+
declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
|
|
2554
|
+
|
|
2356
2555
|
type SyncDocumentKind = "DOC" | "BINARY";
|
|
2357
2556
|
type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
|
|
2358
2557
|
type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
|
|
@@ -2424,6 +2623,7 @@ interface AgenticWorkStatus {
|
|
|
2424
2623
|
teamSync: {
|
|
2425
2624
|
activeWorkCount: number;
|
|
2426
2625
|
staleWorkCount: number;
|
|
2626
|
+
staleWorkExplanation: TeamSyncStaleWorkExplanation;
|
|
2427
2627
|
archivedWorkCount: number;
|
|
2428
2628
|
handoffCount: number;
|
|
2429
2629
|
latestHandoff?: {
|
|
@@ -2849,6 +3049,66 @@ declare function compareLocalSourceSnapshots(previous: LocalSourceSnapshot | nul
|
|
|
2849
3049
|
declare function buildLocalSourceStatus(options?: LocalSourceSnapshotOptions): LocalSourceStatusResult;
|
|
2850
3050
|
declare function buildLocalSourceSyncResult(options?: LocalSourceSyncOptions): Promise<LocalSourceSyncResult>;
|
|
2851
3051
|
|
|
3052
|
+
interface LocalWorkerDeclaration {
|
|
3053
|
+
id: string;
|
|
3054
|
+
workerRole: string;
|
|
3055
|
+
endpointType: "local";
|
|
3056
|
+
provider: string;
|
|
3057
|
+
baseUrl: string;
|
|
3058
|
+
model?: string;
|
|
3059
|
+
preferModel?: string;
|
|
3060
|
+
capabilities: string[];
|
|
3061
|
+
writeScope: string[];
|
|
3062
|
+
createdAt: string;
|
|
3063
|
+
updatedAt: string;
|
|
3064
|
+
}
|
|
3065
|
+
interface LocalWorkersConfig {
|
|
3066
|
+
schemaVersion: "snipara.local_workers.v1";
|
|
3067
|
+
updatedAt: string;
|
|
3068
|
+
defaultWorkerId: string;
|
|
3069
|
+
workers: LocalWorkerDeclaration[];
|
|
3070
|
+
}
|
|
3071
|
+
interface LocalWorkerRoutingDefaults {
|
|
3072
|
+
worker: LocalWorkerDeclaration;
|
|
3073
|
+
routeLocalWorkers: true;
|
|
3074
|
+
routingWorkerRole: string;
|
|
3075
|
+
routingLocalBaseUrl: string;
|
|
3076
|
+
routingLocalModel?: string;
|
|
3077
|
+
routingLocalPreferModel?: string;
|
|
3078
|
+
routingLocalProvider: string;
|
|
3079
|
+
routingPreferredEndpoints: string[];
|
|
3080
|
+
routingAllowedEndpoints: string[];
|
|
3081
|
+
plannerRetainsReasoning: true;
|
|
3082
|
+
}
|
|
3083
|
+
interface LocalWorkerAddOptions {
|
|
3084
|
+
id?: string;
|
|
3085
|
+
role?: string;
|
|
3086
|
+
provider?: string;
|
|
3087
|
+
baseUrl?: string;
|
|
3088
|
+
model?: string;
|
|
3089
|
+
preferModel?: string;
|
|
3090
|
+
capabilities?: string[];
|
|
3091
|
+
writeScope?: string[];
|
|
3092
|
+
default?: boolean;
|
|
3093
|
+
json?: boolean;
|
|
3094
|
+
}
|
|
3095
|
+
interface LocalWorkerStatusOptions {
|
|
3096
|
+
json?: boolean;
|
|
3097
|
+
}
|
|
3098
|
+
declare function workersLocalAddCommand(options: LocalWorkerAddOptions): void;
|
|
3099
|
+
declare function workersLocalStatusCommand(options?: LocalWorkerStatusOptions): void;
|
|
3100
|
+
declare function addLocalWorker(options: LocalWorkerAddOptions): {
|
|
3101
|
+
worker: LocalWorkerDeclaration;
|
|
3102
|
+
config: LocalWorkersConfig;
|
|
3103
|
+
workerConfigPath: string;
|
|
3104
|
+
policyPath: string;
|
|
3105
|
+
};
|
|
3106
|
+
declare function resolveLocalWorkerRoutingDefaults(options?: {
|
|
3107
|
+
workerId?: string;
|
|
3108
|
+
workerRole?: string;
|
|
3109
|
+
}): LocalWorkerRoutingDefaults | null;
|
|
3110
|
+
declare function readLocalWorkersConfig(): LocalWorkersConfig | null;
|
|
3111
|
+
|
|
2852
3112
|
declare const MANIFEST_VERSION = "snipara.references.v1";
|
|
2853
3113
|
type ReferenceStatus = "allowed" | "pending" | "denied" | "unsupported";
|
|
2854
3114
|
interface ReferenceOccurrence {
|
|
@@ -3041,184 +3301,6 @@ declare function installAutomationBundle(args: {
|
|
|
3041
3301
|
}): Promise<AutomationInstallResult>;
|
|
3042
3302
|
declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
|
|
3043
3303
|
|
|
3044
|
-
declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
|
|
3045
|
-
type TeamSyncAttention = "note" | "watch" | "review" | "proof";
|
|
3046
|
-
type TeamSyncWorkStatus = "active" | "completed" | "archived";
|
|
3047
|
-
interface TeamSyncRecordInput {
|
|
3048
|
-
summary: string;
|
|
3049
|
-
files?: string[];
|
|
3050
|
-
branch?: string;
|
|
3051
|
-
actor?: string;
|
|
3052
|
-
next?: string;
|
|
3053
|
-
attention?: string;
|
|
3054
|
-
risk?: string;
|
|
3055
|
-
now?: Date;
|
|
3056
|
-
}
|
|
3057
|
-
interface TeamSyncWorkRecord {
|
|
3058
|
-
id: string;
|
|
3059
|
-
type: "work";
|
|
3060
|
-
summary: string;
|
|
3061
|
-
files: string[];
|
|
3062
|
-
branch?: string;
|
|
3063
|
-
actor?: string;
|
|
3064
|
-
status: TeamSyncWorkStatus;
|
|
3065
|
-
createdAt: string;
|
|
3066
|
-
updatedAt: string;
|
|
3067
|
-
completedAt?: string;
|
|
3068
|
-
completionReason?: string;
|
|
3069
|
-
archivedAt?: string;
|
|
3070
|
-
archiveReason?: string;
|
|
3071
|
-
}
|
|
3072
|
-
interface TeamSyncHandoffRecord {
|
|
3073
|
-
id: string;
|
|
3074
|
-
type: "handoff";
|
|
3075
|
-
summary: string;
|
|
3076
|
-
files: string[];
|
|
3077
|
-
next?: string;
|
|
3078
|
-
attention?: TeamSyncAttention;
|
|
3079
|
-
actor?: string;
|
|
3080
|
-
createdAt: string;
|
|
3081
|
-
}
|
|
3082
|
-
interface TeamSyncState {
|
|
3083
|
-
schemaVersion: "snipara.team-sync.v1";
|
|
3084
|
-
updatedAt: string;
|
|
3085
|
-
work: TeamSyncWorkRecord[];
|
|
3086
|
-
handoffs: TeamSyncHandoffRecord[];
|
|
3087
|
-
}
|
|
3088
|
-
interface TeamSyncSummary {
|
|
3089
|
-
activeWorkCount: number;
|
|
3090
|
-
staleWorkCount: number;
|
|
3091
|
-
completedWorkCount: number;
|
|
3092
|
-
archivedWorkCount: number;
|
|
3093
|
-
handoffCount: number;
|
|
3094
|
-
files: string[];
|
|
3095
|
-
latestActiveWork?: TeamSyncWorkRecord;
|
|
3096
|
-
latestStaleWork?: TeamSyncWorkRecord;
|
|
3097
|
-
latestCompletedWork?: TeamSyncWorkRecord;
|
|
3098
|
-
latestArchivedWork?: TeamSyncWorkRecord;
|
|
3099
|
-
latestHandoff?: TeamSyncHandoffRecord;
|
|
3100
|
-
}
|
|
3101
|
-
interface TeamSyncCommandOptions {
|
|
3102
|
-
id?: string;
|
|
3103
|
-
summary?: string;
|
|
3104
|
-
files?: string[];
|
|
3105
|
-
branch?: string;
|
|
3106
|
-
actor?: string;
|
|
3107
|
-
next?: string;
|
|
3108
|
-
attention?: string;
|
|
3109
|
-
risk?: string;
|
|
3110
|
-
adapterPack?: boolean;
|
|
3111
|
-
adapterTarget?: string;
|
|
3112
|
-
context?: string[];
|
|
3113
|
-
proof?: string[];
|
|
3114
|
-
acceptance?: string[];
|
|
3115
|
-
conflictPosture?: string;
|
|
3116
|
-
since?: string;
|
|
3117
|
-
dir?: string;
|
|
3118
|
-
includeSessionContext?: boolean;
|
|
3119
|
-
emitOrchestratorHandoff?: boolean;
|
|
3120
|
-
autoRouteOrchestrator?: boolean;
|
|
3121
|
-
orchestratorPolicySource?: string;
|
|
3122
|
-
output?: string;
|
|
3123
|
-
days?: string;
|
|
3124
|
-
dryRun?: boolean;
|
|
3125
|
-
json?: boolean;
|
|
3126
|
-
}
|
|
3127
|
-
interface HostedAttempt<T> {
|
|
3128
|
-
status: "skipped" | "ok" | "error";
|
|
3129
|
-
data?: T;
|
|
3130
|
-
error?: string;
|
|
3131
|
-
}
|
|
3132
|
-
interface TeamSyncSweepResult {
|
|
3133
|
-
action: "sweep";
|
|
3134
|
-
statePath: string;
|
|
3135
|
-
dryRun: boolean;
|
|
3136
|
-
thresholdDays: number;
|
|
3137
|
-
thresholdMs: number;
|
|
3138
|
-
archivedCount: number;
|
|
3139
|
-
archivedWork: TeamSyncWorkRecord[];
|
|
3140
|
-
summary: TeamSyncSummary;
|
|
3141
|
-
}
|
|
3142
|
-
type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
|
|
3143
|
-
type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
|
|
3144
|
-
interface AgenticHandoffAdapterPack {
|
|
3145
|
-
version: "snipara.ade_adapter_pack.v1";
|
|
3146
|
-
target: {
|
|
3147
|
-
id: AgenticHandoffAdapterTarget;
|
|
3148
|
-
label: string;
|
|
3149
|
-
instruction: string;
|
|
3150
|
-
};
|
|
3151
|
-
contextPack: {
|
|
3152
|
-
summary: string;
|
|
3153
|
-
files: string[];
|
|
3154
|
-
contextRefs: string[];
|
|
3155
|
-
workflow?: {
|
|
3156
|
-
goal?: string;
|
|
3157
|
-
status?: string;
|
|
3158
|
-
currentPhaseId?: string;
|
|
3159
|
-
currentPhaseTitle?: string;
|
|
3160
|
-
};
|
|
3161
|
-
resumeCommands: string[];
|
|
3162
|
-
constraints: string[];
|
|
3163
|
-
};
|
|
3164
|
-
conflictPosture: AgenticHandoffConflictPosture;
|
|
3165
|
-
proofGates: string[];
|
|
3166
|
-
acceptanceCriteria: string[];
|
|
3167
|
-
receiptExpectation: {
|
|
3168
|
-
required: boolean;
|
|
3169
|
-
command: string;
|
|
3170
|
-
requiredFields: string[];
|
|
3171
|
-
};
|
|
3172
|
-
prompt: string;
|
|
3173
|
-
caveats: string[];
|
|
3174
|
-
}
|
|
3175
|
-
interface TeamSyncCompletionEvidenceOptions {
|
|
3176
|
-
summary?: string;
|
|
3177
|
-
workflowGoal?: string;
|
|
3178
|
-
files?: string[];
|
|
3179
|
-
reason?: string;
|
|
3180
|
-
now?: Date;
|
|
3181
|
-
dryRun?: boolean;
|
|
3182
|
-
}
|
|
3183
|
-
interface AgenticHandoffArtifact {
|
|
3184
|
-
version: "snipara.agentic_handoff.v1";
|
|
3185
|
-
generatedAt: string;
|
|
3186
|
-
command: "snipara-companion handoff";
|
|
3187
|
-
record: TeamSyncHandoffRecord;
|
|
3188
|
-
statePath: string;
|
|
3189
|
-
hosted: {
|
|
3190
|
-
status: HostedAttempt<TeamSyncHandoffResponse>["status"];
|
|
3191
|
-
handoffId?: string;
|
|
3192
|
-
error?: string;
|
|
3193
|
-
};
|
|
3194
|
-
sections: {
|
|
3195
|
-
whatChanged: string[];
|
|
3196
|
-
verified: string[];
|
|
3197
|
-
risky: string[];
|
|
3198
|
-
remains: string[];
|
|
3199
|
-
whereToResume: string[];
|
|
3200
|
-
};
|
|
3201
|
-
suggestedCommands: string[];
|
|
3202
|
-
adapter?: AgenticHandoffAdapterPack;
|
|
3203
|
-
}
|
|
3204
|
-
declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
|
|
3205
|
-
declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
|
|
3206
|
-
declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
|
|
3207
|
-
declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
|
|
3208
|
-
declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
|
|
3209
|
-
now?: Date;
|
|
3210
|
-
thresholdMs?: number;
|
|
3211
|
-
dryRun?: boolean;
|
|
3212
|
-
}): TeamSyncSweepResult["archivedWork"];
|
|
3213
|
-
declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
3214
|
-
declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
3215
|
-
declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
|
|
3216
|
-
declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
|
|
3217
|
-
declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
|
|
3218
|
-
declare function getTeamSyncStatePath(rootDir?: string): string;
|
|
3219
|
-
declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
|
|
3220
|
-
declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
|
|
3221
|
-
|
|
3222
3304
|
declare const COLLABORATION_STATE_RELATIVE_PATH: string;
|
|
3223
3305
|
type CollaborationGuardActionKind = "safe_to_ack" | "needs_handoff" | "needs_test" | "needs_package_review" | "blocking_conflict" | "guard_unavailable";
|
|
3224
3306
|
interface CollaborationGuardActionCard {
|
|
@@ -3644,4 +3726,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
|
|
|
3644
3726
|
declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
|
|
3645
3727
|
declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
|
|
3646
3728
|
|
|
3647
|
-
export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, 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, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };
|
|
3729
|
+
export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, 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, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, 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, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };
|