snipara-companion 3.0.2 → 3.0.4
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 +277 -179
- package/dist/index.js +1513 -829
- package/docs/FULL_REFERENCE.md +32 -2
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1971,6 +1971,7 @@ interface MemoryAuditResult {
|
|
|
1971
1971
|
version: "snipara.memory_audit.v1";
|
|
1972
1972
|
generatedAt: string;
|
|
1973
1973
|
scope?: MemoryScope;
|
|
1974
|
+
summary?: MemoryAuditSummary;
|
|
1974
1975
|
health?: Record<string, unknown>;
|
|
1975
1976
|
cleanCandidates?: Record<string, unknown>;
|
|
1976
1977
|
compactDryRun?: Record<string, unknown>;
|
|
@@ -1979,6 +1980,16 @@ interface MemoryAuditResult {
|
|
|
1979
1980
|
message: string;
|
|
1980
1981
|
}>;
|
|
1981
1982
|
}
|
|
1983
|
+
interface MemoryAuditSummary {
|
|
1984
|
+
totalScanned?: number;
|
|
1985
|
+
activeCount?: number;
|
|
1986
|
+
autoCompactThreshold?: number;
|
|
1987
|
+
autoCompactWouldTrigger?: boolean;
|
|
1988
|
+
cleanupCandidateCounts: Record<string, number>;
|
|
1989
|
+
compactDryRunMutated?: boolean;
|
|
1990
|
+
compactDryRunPlannedActions?: number;
|
|
1991
|
+
recommendedActions: string[];
|
|
1992
|
+
}
|
|
1982
1993
|
declare function memoryHealthCommand(options: MemoryHealthCommandOptions): Promise<void>;
|
|
1983
1994
|
declare function memoryCleanCandidatesCommand(options: MemoryCleanCandidatesCommandOptions): Promise<void>;
|
|
1984
1995
|
declare function memoryCompactCommand(options: MemoryCompactCommandOptions): Promise<void>;
|
|
@@ -2355,6 +2366,210 @@ interface ProjectIntelligenceRunResult {
|
|
|
2355
2366
|
declare function buildProjectIntelligenceRun(options: ProjectRunCommandOptions): Promise<ProjectIntelligenceRunResult>;
|
|
2356
2367
|
declare function projectIntelligenceRunCommand(options: ProjectRunCommandOptions): Promise<void>;
|
|
2357
2368
|
|
|
2369
|
+
declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
|
|
2370
|
+
type TeamSyncAttention = "note" | "watch" | "review" | "proof";
|
|
2371
|
+
type TeamSyncWorkStatus = "active" | "completed" | "archived";
|
|
2372
|
+
interface TeamSyncRecordInput {
|
|
2373
|
+
summary: string;
|
|
2374
|
+
files?: string[];
|
|
2375
|
+
branch?: string;
|
|
2376
|
+
actor?: string;
|
|
2377
|
+
next?: string;
|
|
2378
|
+
attention?: string;
|
|
2379
|
+
risk?: string;
|
|
2380
|
+
now?: Date;
|
|
2381
|
+
}
|
|
2382
|
+
interface TeamSyncWorkRecord {
|
|
2383
|
+
id: string;
|
|
2384
|
+
type: "work";
|
|
2385
|
+
summary: string;
|
|
2386
|
+
files: string[];
|
|
2387
|
+
branch?: string;
|
|
2388
|
+
actor?: string;
|
|
2389
|
+
status: TeamSyncWorkStatus;
|
|
2390
|
+
createdAt: string;
|
|
2391
|
+
updatedAt: string;
|
|
2392
|
+
completedAt?: string;
|
|
2393
|
+
completionReason?: string;
|
|
2394
|
+
archivedAt?: string;
|
|
2395
|
+
archiveReason?: string;
|
|
2396
|
+
}
|
|
2397
|
+
interface TeamSyncHandoffRecord {
|
|
2398
|
+
id: string;
|
|
2399
|
+
type: "handoff";
|
|
2400
|
+
summary: string;
|
|
2401
|
+
files: string[];
|
|
2402
|
+
next?: string;
|
|
2403
|
+
attention?: TeamSyncAttention;
|
|
2404
|
+
actor?: string;
|
|
2405
|
+
createdAt: string;
|
|
2406
|
+
}
|
|
2407
|
+
interface TeamSyncState {
|
|
2408
|
+
schemaVersion: "snipara.team-sync.v1";
|
|
2409
|
+
updatedAt: string;
|
|
2410
|
+
work: TeamSyncWorkRecord[];
|
|
2411
|
+
handoffs: TeamSyncHandoffRecord[];
|
|
2412
|
+
}
|
|
2413
|
+
interface TeamSyncSummary {
|
|
2414
|
+
activeWorkCount: number;
|
|
2415
|
+
staleWorkCount: number;
|
|
2416
|
+
completedWorkCount: number;
|
|
2417
|
+
archivedWorkCount: number;
|
|
2418
|
+
handoffCount: number;
|
|
2419
|
+
files: string[];
|
|
2420
|
+
staleWorkExplanation: TeamSyncStaleWorkExplanation;
|
|
2421
|
+
hygieneActions: TeamSyncHygieneAction[];
|
|
2422
|
+
latestActiveWork?: TeamSyncWorkRecord;
|
|
2423
|
+
latestStaleWork?: TeamSyncWorkRecord;
|
|
2424
|
+
latestCompletedWork?: TeamSyncWorkRecord;
|
|
2425
|
+
latestArchivedWork?: TeamSyncWorkRecord;
|
|
2426
|
+
latestHandoff?: TeamSyncHandoffRecord;
|
|
2427
|
+
}
|
|
2428
|
+
interface TeamSyncStaleWorkExplanation {
|
|
2429
|
+
staleAfterHours: number;
|
|
2430
|
+
autoArchiveAfterDays: number;
|
|
2431
|
+
activeStaleCount: number;
|
|
2432
|
+
autoArchivableCount: number;
|
|
2433
|
+
completedIgnoredCount: number;
|
|
2434
|
+
archivedIgnoredCount: number;
|
|
2435
|
+
latestStaleWorkAgeHours?: number;
|
|
2436
|
+
message: string;
|
|
2437
|
+
}
|
|
2438
|
+
interface TeamSyncHygieneAction {
|
|
2439
|
+
kind: "sweep-preview" | "sweep-archive" | "complete-work" | "handoff";
|
|
2440
|
+
command: string;
|
|
2441
|
+
reason: string;
|
|
2442
|
+
mutates: boolean;
|
|
2443
|
+
}
|
|
2444
|
+
interface TeamSyncCommandOptions {
|
|
2445
|
+
id?: string;
|
|
2446
|
+
summary?: string;
|
|
2447
|
+
files?: string[];
|
|
2448
|
+
branch?: string;
|
|
2449
|
+
actor?: string;
|
|
2450
|
+
next?: string;
|
|
2451
|
+
attention?: string;
|
|
2452
|
+
risk?: string;
|
|
2453
|
+
adapterPack?: boolean;
|
|
2454
|
+
adapterTarget?: string;
|
|
2455
|
+
context?: string[];
|
|
2456
|
+
proof?: string[];
|
|
2457
|
+
acceptance?: string[];
|
|
2458
|
+
conflictPosture?: string;
|
|
2459
|
+
since?: string;
|
|
2460
|
+
dir?: string;
|
|
2461
|
+
includeSessionContext?: boolean;
|
|
2462
|
+
emitOrchestratorHandoff?: boolean;
|
|
2463
|
+
autoRouteOrchestrator?: boolean;
|
|
2464
|
+
orchestratorPolicySource?: string;
|
|
2465
|
+
output?: string;
|
|
2466
|
+
days?: string;
|
|
2467
|
+
dryRun?: boolean;
|
|
2468
|
+
json?: boolean;
|
|
2469
|
+
}
|
|
2470
|
+
interface HostedAttempt<T> {
|
|
2471
|
+
status: "skipped" | "ok" | "error";
|
|
2472
|
+
data?: T;
|
|
2473
|
+
error?: string;
|
|
2474
|
+
}
|
|
2475
|
+
interface TeamSyncSweepResult {
|
|
2476
|
+
action: "sweep";
|
|
2477
|
+
statePath: string;
|
|
2478
|
+
dryRun: boolean;
|
|
2479
|
+
thresholdDays: number;
|
|
2480
|
+
thresholdMs: number;
|
|
2481
|
+
archivedCount: number;
|
|
2482
|
+
archivedWork: TeamSyncWorkRecord[];
|
|
2483
|
+
explanation: TeamSyncSweepExplanation;
|
|
2484
|
+
summary: TeamSyncSummary;
|
|
2485
|
+
}
|
|
2486
|
+
interface TeamSyncSweepExplanation {
|
|
2487
|
+
mode: "preview" | "archive";
|
|
2488
|
+
candidateCount: number;
|
|
2489
|
+
archivedCount: number;
|
|
2490
|
+
remainingStaleCount: number;
|
|
2491
|
+
message: string;
|
|
2492
|
+
}
|
|
2493
|
+
type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
|
|
2494
|
+
type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
|
|
2495
|
+
interface AgenticHandoffAdapterPack {
|
|
2496
|
+
version: "snipara.ade_adapter_pack.v1";
|
|
2497
|
+
target: {
|
|
2498
|
+
id: AgenticHandoffAdapterTarget;
|
|
2499
|
+
label: string;
|
|
2500
|
+
instruction: string;
|
|
2501
|
+
};
|
|
2502
|
+
contextPack: {
|
|
2503
|
+
summary: string;
|
|
2504
|
+
files: string[];
|
|
2505
|
+
contextRefs: string[];
|
|
2506
|
+
workflow?: {
|
|
2507
|
+
goal?: string;
|
|
2508
|
+
status?: string;
|
|
2509
|
+
currentPhaseId?: string;
|
|
2510
|
+
currentPhaseTitle?: string;
|
|
2511
|
+
};
|
|
2512
|
+
resumeCommands: string[];
|
|
2513
|
+
constraints: string[];
|
|
2514
|
+
};
|
|
2515
|
+
conflictPosture: AgenticHandoffConflictPosture;
|
|
2516
|
+
proofGates: string[];
|
|
2517
|
+
acceptanceCriteria: string[];
|
|
2518
|
+
receiptExpectation: {
|
|
2519
|
+
required: boolean;
|
|
2520
|
+
command: string;
|
|
2521
|
+
requiredFields: string[];
|
|
2522
|
+
};
|
|
2523
|
+
prompt: string;
|
|
2524
|
+
caveats: string[];
|
|
2525
|
+
}
|
|
2526
|
+
interface TeamSyncCompletionEvidenceOptions {
|
|
2527
|
+
summary?: string;
|
|
2528
|
+
workflowGoal?: string;
|
|
2529
|
+
files?: string[];
|
|
2530
|
+
reason?: string;
|
|
2531
|
+
now?: Date;
|
|
2532
|
+
dryRun?: boolean;
|
|
2533
|
+
}
|
|
2534
|
+
interface AgenticHandoffArtifact {
|
|
2535
|
+
version: "snipara.agentic_handoff.v1";
|
|
2536
|
+
generatedAt: string;
|
|
2537
|
+
command: "snipara-companion handoff";
|
|
2538
|
+
record: TeamSyncHandoffRecord;
|
|
2539
|
+
statePath: string;
|
|
2540
|
+
hosted: {
|
|
2541
|
+
status: HostedAttempt<TeamSyncHandoffResponse>["status"];
|
|
2542
|
+
handoffId?: string;
|
|
2543
|
+
error?: string;
|
|
2544
|
+
};
|
|
2545
|
+
sections: {
|
|
2546
|
+
whatChanged: string[];
|
|
2547
|
+
verified: string[];
|
|
2548
|
+
risky: string[];
|
|
2549
|
+
remains: string[];
|
|
2550
|
+
whereToResume: string[];
|
|
2551
|
+
};
|
|
2552
|
+
suggestedCommands: string[];
|
|
2553
|
+
adapter?: AgenticHandoffAdapterPack;
|
|
2554
|
+
}
|
|
2555
|
+
declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
|
|
2556
|
+
declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
|
|
2557
|
+
declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
|
|
2558
|
+
declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
|
|
2559
|
+
declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
|
|
2560
|
+
now?: Date;
|
|
2561
|
+
thresholdMs?: number;
|
|
2562
|
+
dryRun?: boolean;
|
|
2563
|
+
}): TeamSyncSweepResult["archivedWork"];
|
|
2564
|
+
declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
2565
|
+
declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
2566
|
+
declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
|
|
2567
|
+
declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
|
|
2568
|
+
declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
|
|
2569
|
+
declare function getTeamSyncStatePath(rootDir?: string): string;
|
|
2570
|
+
declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
|
|
2571
|
+
declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
|
|
2572
|
+
|
|
2358
2573
|
type SyncDocumentKind = "DOC" | "BINARY";
|
|
2359
2574
|
type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
|
|
2360
2575
|
type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
|
|
@@ -2426,6 +2641,7 @@ interface AgenticWorkStatus {
|
|
|
2426
2641
|
teamSync: {
|
|
2427
2642
|
activeWorkCount: number;
|
|
2428
2643
|
staleWorkCount: number;
|
|
2644
|
+
staleWorkExplanation: TeamSyncStaleWorkExplanation;
|
|
2429
2645
|
archivedWorkCount: number;
|
|
2430
2646
|
handoffCount: number;
|
|
2431
2647
|
latestHandoff?: {
|
|
@@ -2851,6 +3067,66 @@ declare function compareLocalSourceSnapshots(previous: LocalSourceSnapshot | nul
|
|
|
2851
3067
|
declare function buildLocalSourceStatus(options?: LocalSourceSnapshotOptions): LocalSourceStatusResult;
|
|
2852
3068
|
declare function buildLocalSourceSyncResult(options?: LocalSourceSyncOptions): Promise<LocalSourceSyncResult>;
|
|
2853
3069
|
|
|
3070
|
+
interface LocalWorkerDeclaration {
|
|
3071
|
+
id: string;
|
|
3072
|
+
workerRole: string;
|
|
3073
|
+
endpointType: "local";
|
|
3074
|
+
provider: string;
|
|
3075
|
+
baseUrl: string;
|
|
3076
|
+
model?: string;
|
|
3077
|
+
preferModel?: string;
|
|
3078
|
+
capabilities: string[];
|
|
3079
|
+
writeScope: string[];
|
|
3080
|
+
createdAt: string;
|
|
3081
|
+
updatedAt: string;
|
|
3082
|
+
}
|
|
3083
|
+
interface LocalWorkersConfig {
|
|
3084
|
+
schemaVersion: "snipara.local_workers.v1";
|
|
3085
|
+
updatedAt: string;
|
|
3086
|
+
defaultWorkerId: string;
|
|
3087
|
+
workers: LocalWorkerDeclaration[];
|
|
3088
|
+
}
|
|
3089
|
+
interface LocalWorkerRoutingDefaults {
|
|
3090
|
+
worker: LocalWorkerDeclaration;
|
|
3091
|
+
routeLocalWorkers: true;
|
|
3092
|
+
routingWorkerRole: string;
|
|
3093
|
+
routingLocalBaseUrl: string;
|
|
3094
|
+
routingLocalModel?: string;
|
|
3095
|
+
routingLocalPreferModel?: string;
|
|
3096
|
+
routingLocalProvider: string;
|
|
3097
|
+
routingPreferredEndpoints: string[];
|
|
3098
|
+
routingAllowedEndpoints: string[];
|
|
3099
|
+
plannerRetainsReasoning: true;
|
|
3100
|
+
}
|
|
3101
|
+
interface LocalWorkerAddOptions {
|
|
3102
|
+
id?: string;
|
|
3103
|
+
role?: string;
|
|
3104
|
+
provider?: string;
|
|
3105
|
+
baseUrl?: string;
|
|
3106
|
+
model?: string;
|
|
3107
|
+
preferModel?: string;
|
|
3108
|
+
capabilities?: string[];
|
|
3109
|
+
writeScope?: string[];
|
|
3110
|
+
default?: boolean;
|
|
3111
|
+
json?: boolean;
|
|
3112
|
+
}
|
|
3113
|
+
interface LocalWorkerStatusOptions {
|
|
3114
|
+
json?: boolean;
|
|
3115
|
+
}
|
|
3116
|
+
declare function workersLocalAddCommand(options: LocalWorkerAddOptions): void;
|
|
3117
|
+
declare function workersLocalStatusCommand(options?: LocalWorkerStatusOptions): void;
|
|
3118
|
+
declare function addLocalWorker(options: LocalWorkerAddOptions): {
|
|
3119
|
+
worker: LocalWorkerDeclaration;
|
|
3120
|
+
config: LocalWorkersConfig;
|
|
3121
|
+
workerConfigPath: string;
|
|
3122
|
+
policyPath: string;
|
|
3123
|
+
};
|
|
3124
|
+
declare function resolveLocalWorkerRoutingDefaults(options?: {
|
|
3125
|
+
workerId?: string;
|
|
3126
|
+
workerRole?: string;
|
|
3127
|
+
}): LocalWorkerRoutingDefaults | null;
|
|
3128
|
+
declare function readLocalWorkersConfig(): LocalWorkersConfig | null;
|
|
3129
|
+
|
|
2854
3130
|
declare const MANIFEST_VERSION = "snipara.references.v1";
|
|
2855
3131
|
type ReferenceStatus = "allowed" | "pending" | "denied" | "unsupported";
|
|
2856
3132
|
interface ReferenceOccurrence {
|
|
@@ -3043,184 +3319,6 @@ declare function installAutomationBundle(args: {
|
|
|
3043
3319
|
}): Promise<AutomationInstallResult>;
|
|
3044
3320
|
declare function getAutomationStatus(projectDir?: string): AutomationStatusResult;
|
|
3045
3321
|
|
|
3046
|
-
declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
|
|
3047
|
-
type TeamSyncAttention = "note" | "watch" | "review" | "proof";
|
|
3048
|
-
type TeamSyncWorkStatus = "active" | "completed" | "archived";
|
|
3049
|
-
interface TeamSyncRecordInput {
|
|
3050
|
-
summary: string;
|
|
3051
|
-
files?: string[];
|
|
3052
|
-
branch?: string;
|
|
3053
|
-
actor?: string;
|
|
3054
|
-
next?: string;
|
|
3055
|
-
attention?: string;
|
|
3056
|
-
risk?: string;
|
|
3057
|
-
now?: Date;
|
|
3058
|
-
}
|
|
3059
|
-
interface TeamSyncWorkRecord {
|
|
3060
|
-
id: string;
|
|
3061
|
-
type: "work";
|
|
3062
|
-
summary: string;
|
|
3063
|
-
files: string[];
|
|
3064
|
-
branch?: string;
|
|
3065
|
-
actor?: string;
|
|
3066
|
-
status: TeamSyncWorkStatus;
|
|
3067
|
-
createdAt: string;
|
|
3068
|
-
updatedAt: string;
|
|
3069
|
-
completedAt?: string;
|
|
3070
|
-
completionReason?: string;
|
|
3071
|
-
archivedAt?: string;
|
|
3072
|
-
archiveReason?: string;
|
|
3073
|
-
}
|
|
3074
|
-
interface TeamSyncHandoffRecord {
|
|
3075
|
-
id: string;
|
|
3076
|
-
type: "handoff";
|
|
3077
|
-
summary: string;
|
|
3078
|
-
files: string[];
|
|
3079
|
-
next?: string;
|
|
3080
|
-
attention?: TeamSyncAttention;
|
|
3081
|
-
actor?: string;
|
|
3082
|
-
createdAt: string;
|
|
3083
|
-
}
|
|
3084
|
-
interface TeamSyncState {
|
|
3085
|
-
schemaVersion: "snipara.team-sync.v1";
|
|
3086
|
-
updatedAt: string;
|
|
3087
|
-
work: TeamSyncWorkRecord[];
|
|
3088
|
-
handoffs: TeamSyncHandoffRecord[];
|
|
3089
|
-
}
|
|
3090
|
-
interface TeamSyncSummary {
|
|
3091
|
-
activeWorkCount: number;
|
|
3092
|
-
staleWorkCount: number;
|
|
3093
|
-
completedWorkCount: number;
|
|
3094
|
-
archivedWorkCount: number;
|
|
3095
|
-
handoffCount: number;
|
|
3096
|
-
files: string[];
|
|
3097
|
-
latestActiveWork?: TeamSyncWorkRecord;
|
|
3098
|
-
latestStaleWork?: TeamSyncWorkRecord;
|
|
3099
|
-
latestCompletedWork?: TeamSyncWorkRecord;
|
|
3100
|
-
latestArchivedWork?: TeamSyncWorkRecord;
|
|
3101
|
-
latestHandoff?: TeamSyncHandoffRecord;
|
|
3102
|
-
}
|
|
3103
|
-
interface TeamSyncCommandOptions {
|
|
3104
|
-
id?: string;
|
|
3105
|
-
summary?: string;
|
|
3106
|
-
files?: string[];
|
|
3107
|
-
branch?: string;
|
|
3108
|
-
actor?: string;
|
|
3109
|
-
next?: string;
|
|
3110
|
-
attention?: string;
|
|
3111
|
-
risk?: string;
|
|
3112
|
-
adapterPack?: boolean;
|
|
3113
|
-
adapterTarget?: string;
|
|
3114
|
-
context?: string[];
|
|
3115
|
-
proof?: string[];
|
|
3116
|
-
acceptance?: string[];
|
|
3117
|
-
conflictPosture?: string;
|
|
3118
|
-
since?: string;
|
|
3119
|
-
dir?: string;
|
|
3120
|
-
includeSessionContext?: boolean;
|
|
3121
|
-
emitOrchestratorHandoff?: boolean;
|
|
3122
|
-
autoRouteOrchestrator?: boolean;
|
|
3123
|
-
orchestratorPolicySource?: string;
|
|
3124
|
-
output?: string;
|
|
3125
|
-
days?: string;
|
|
3126
|
-
dryRun?: boolean;
|
|
3127
|
-
json?: boolean;
|
|
3128
|
-
}
|
|
3129
|
-
interface HostedAttempt<T> {
|
|
3130
|
-
status: "skipped" | "ok" | "error";
|
|
3131
|
-
data?: T;
|
|
3132
|
-
error?: string;
|
|
3133
|
-
}
|
|
3134
|
-
interface TeamSyncSweepResult {
|
|
3135
|
-
action: "sweep";
|
|
3136
|
-
statePath: string;
|
|
3137
|
-
dryRun: boolean;
|
|
3138
|
-
thresholdDays: number;
|
|
3139
|
-
thresholdMs: number;
|
|
3140
|
-
archivedCount: number;
|
|
3141
|
-
archivedWork: TeamSyncWorkRecord[];
|
|
3142
|
-
summary: TeamSyncSummary;
|
|
3143
|
-
}
|
|
3144
|
-
type AgenticHandoffAdapterTarget = "codex" | "claude-code" | "cursor" | "orca" | "windsurf" | "custom";
|
|
3145
|
-
type AgenticHandoffConflictPosture = "continue" | "wait" | "split_work" | "review_only" | "handoff";
|
|
3146
|
-
interface AgenticHandoffAdapterPack {
|
|
3147
|
-
version: "snipara.ade_adapter_pack.v1";
|
|
3148
|
-
target: {
|
|
3149
|
-
id: AgenticHandoffAdapterTarget;
|
|
3150
|
-
label: string;
|
|
3151
|
-
instruction: string;
|
|
3152
|
-
};
|
|
3153
|
-
contextPack: {
|
|
3154
|
-
summary: string;
|
|
3155
|
-
files: string[];
|
|
3156
|
-
contextRefs: string[];
|
|
3157
|
-
workflow?: {
|
|
3158
|
-
goal?: string;
|
|
3159
|
-
status?: string;
|
|
3160
|
-
currentPhaseId?: string;
|
|
3161
|
-
currentPhaseTitle?: string;
|
|
3162
|
-
};
|
|
3163
|
-
resumeCommands: string[];
|
|
3164
|
-
constraints: string[];
|
|
3165
|
-
};
|
|
3166
|
-
conflictPosture: AgenticHandoffConflictPosture;
|
|
3167
|
-
proofGates: string[];
|
|
3168
|
-
acceptanceCriteria: string[];
|
|
3169
|
-
receiptExpectation: {
|
|
3170
|
-
required: boolean;
|
|
3171
|
-
command: string;
|
|
3172
|
-
requiredFields: string[];
|
|
3173
|
-
};
|
|
3174
|
-
prompt: string;
|
|
3175
|
-
caveats: string[];
|
|
3176
|
-
}
|
|
3177
|
-
interface TeamSyncCompletionEvidenceOptions {
|
|
3178
|
-
summary?: string;
|
|
3179
|
-
workflowGoal?: string;
|
|
3180
|
-
files?: string[];
|
|
3181
|
-
reason?: string;
|
|
3182
|
-
now?: Date;
|
|
3183
|
-
dryRun?: boolean;
|
|
3184
|
-
}
|
|
3185
|
-
interface AgenticHandoffArtifact {
|
|
3186
|
-
version: "snipara.agentic_handoff.v1";
|
|
3187
|
-
generatedAt: string;
|
|
3188
|
-
command: "snipara-companion handoff";
|
|
3189
|
-
record: TeamSyncHandoffRecord;
|
|
3190
|
-
statePath: string;
|
|
3191
|
-
hosted: {
|
|
3192
|
-
status: HostedAttempt<TeamSyncHandoffResponse>["status"];
|
|
3193
|
-
handoffId?: string;
|
|
3194
|
-
error?: string;
|
|
3195
|
-
};
|
|
3196
|
-
sections: {
|
|
3197
|
-
whatChanged: string[];
|
|
3198
|
-
verified: string[];
|
|
3199
|
-
risky: string[];
|
|
3200
|
-
remains: string[];
|
|
3201
|
-
whereToResume: string[];
|
|
3202
|
-
};
|
|
3203
|
-
suggestedCommands: string[];
|
|
3204
|
-
adapter?: AgenticHandoffAdapterPack;
|
|
3205
|
-
}
|
|
3206
|
-
declare function buildTeamSyncStartWorkRecord(input: TeamSyncRecordInput): TeamSyncWorkRecord;
|
|
3207
|
-
declare function buildTeamSyncHandoffRecord(input: TeamSyncRecordInput): TeamSyncHandoffRecord;
|
|
3208
|
-
declare function createEmptyTeamSyncState(now?: Date): TeamSyncState;
|
|
3209
|
-
declare function buildTeamSyncSummary(state: TeamSyncState, since?: Date, now?: Date): TeamSyncSummary;
|
|
3210
|
-
declare function archiveInactiveTeamSyncWork(state: TeamSyncState, options?: {
|
|
3211
|
-
now?: Date;
|
|
3212
|
-
thresholdMs?: number;
|
|
3213
|
-
dryRun?: boolean;
|
|
3214
|
-
}): TeamSyncSweepResult["archivedWork"];
|
|
3215
|
-
declare function completeTeamSyncWorkFromEvidence(state: TeamSyncState, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
3216
|
-
declare function completeTeamSyncStateFromEvidence(rootDir?: string, options?: TeamSyncCompletionEvidenceOptions): TeamSyncWorkRecord[];
|
|
3217
|
-
declare function autoArchiveTeamSyncState(rootDir?: string, now?: Date): TeamSyncSweepResult["archivedWork"];
|
|
3218
|
-
declare function loadTeamSyncState(rootDir?: string): TeamSyncState;
|
|
3219
|
-
declare function saveTeamSyncState(state: TeamSyncState, rootDir?: string): void;
|
|
3220
|
-
declare function getTeamSyncStatePath(rootDir?: string): string;
|
|
3221
|
-
declare function buildAgenticHandoffMarkdown(artifact: AgenticHandoffArtifact): string;
|
|
3222
|
-
declare function teamSyncSweepCommand(options: TeamSyncCommandOptions): Promise<void>;
|
|
3223
|
-
|
|
3224
3322
|
declare const COLLABORATION_STATE_RELATIVE_PATH: string;
|
|
3225
3323
|
type CollaborationGuardActionKind = "safe_to_ack" | "needs_handoff" | "needs_test" | "needs_package_review" | "blocking_conflict" | "guard_unavailable";
|
|
3226
3324
|
interface CollaborationGuardActionCard {
|
|
@@ -3646,4 +3744,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
|
|
|
3646
3744
|
declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
|
|
3647
3745
|
declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
|
|
3648
3746
|
|
|
3649
|
-
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, 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 };
|
|
3747
|
+
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 };
|