dorfl 0.0.0 → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+export type { Brand } from './brand.js';
+export { BASE, brand, deriveBrand, paramCase, constantCase } from './brand.js';
+export type { Config, PartialConfig, IntegrationMode, HarnessAdapter, ReviewProviderName, VerifyConfig, } from './config.js';
+export { DEFAULT_CONFIG, mergeConfig, loadConfig, saveConfig, defaultConfigPath, } from './config.js';
+export type { RepoAllowedKey, RepoRejectedKey, LoadedRepoConfig, ResolveRepoConfigOptions, ResolvedRepoConfig, } from './repo-config.js';
+export { REPO_CONFIG_FILENAME, REPO_ALLOWED_KEYS, REPO_REJECTED_KEYS, repoConfigPath, loadRepoConfig, resolveRepoConfig, } from './repo-config.js';
+export type { ConfigOverrideMap } from './config-override.js';
+export { defaultConfigOverridePath, loadConfigOverride, } from './config-override.js';
+export type { EnvMap } from './env-config.js';
+export { ENV_PREFIX, envVarName, envOverrides } from './env-config.js';
+export type { RenderTaskBodyInput, RenderSpecBodyInput, } from './buildable-body.js';
+export { renderTaskBody, renderSpecBody } from './buildable-body.js';
+export type { Frontmatter } from './frontmatter.js';
+export { parseFrontmatter, setNeedsAnswersMarker, setFrontmatterMarker, } from './frontmatter.js';
+export type { SidecarType, SidecarEntry, SidecarModel, SidecarIdentity, NewQuestion, } from './sidecar.js';
+export { SidecarParseError, isEntryAnswered, pendingEntries, allAnswered, resolveSidecarIdentity, sidecarPathFor, sidecarPathCandidates, parseSidecar, serialiseSidecar, appendQuestions, newSidecar, } from './sidecar.js';
+export type { ApplyMode, ApplyAtomicOptions, ApplyAtomicResult, } from './sidecar-apply.js';
+export { ApplyAtomicError, applyAtomic } from './sidecar-apply.js';
+export type { ApplyTerminal, ApplyAnsweredQuestionsOptions, ApplyAnsweredQuestionsResult, } from './apply-persist.js';
+export { ApplyPersistError, applyAnsweredQuestions } from './apply-persist.js';
+export type { MintAdrOptions, MintAdrResult } from './mint-adr.js';
+export { MintAdrError, mintAdr, buildAdrBody, adrItemRel } from './mint-adr.js';
+export { APPLY_LIFECYCLE_FOLDERS, resolveItemPathByIdentity, } from './item-path.js';
+export type { DropSourceOptions, DropSourceResult, DropTerminal, } from './drop-source.js';
+export { DropSourceError, dropSource } from './drop-source.js';
+export type { TickItem, TickRungKind, TickClassification, } from './advance-classify.js';
+export { classifyTick, isAdvanceable } from './advance-classify.js';
+export { isParticipatingRepo, findParticipatingRepos } from './detect.js';
+export type { HumanOnlyGate, BlockedByResult, EligibilityInput, EligibilityResult, } from './eligibility.js';
+export { resolveGate, resolveBlockedBy, resolveEligibility, } from './eligibility.js';
+export type { TaskedAfterResult, TaskingEligibilityInput, TaskingEligibilityResult, } from './tasking-eligibility.js';
+export { resolveTaskGate, resolveTaskedAfter, resolveTaskingEligibility, } from './tasking-eligibility.js';
+export type { LedgerReadyItem, LedgerObservationItem, LedgerSpecItem, LedgerSpecPool, SpecExistence, LocalLedgerState, ArbiterLedgerState, ResolveLocalStateInput, ResolveSpecExistenceInput, ResolveSpecPoolInput, ResolveArbiterStateInput, ResolveMirrorStateInput, LedgerReadStrategy, } from './ledger-read.js';
+export { currentLedgerRead, ledgerRead } from './ledger-read.js';
+export type { SpecCompleteInput, SpecTask, SpecCompleteResult, } from './spec-complete.js';
+export { isSpecComplete } from './spec-complete.js';
+export type { LedgerTransitionKind, ApplyTransitionInput, ApplyTransitionResult, ApplyCompleteTransitionInput, ApplyCompleteTransitionResult, ApplyNeedsAttentionTransitionInput, ApplyNeedsAttentionTransitionResult, ApplyReturnToBacklogTransitionInput, ApplyReturnToBacklogTransitionResult, LedgerWriteStrategy, } from './ledger-write.js';
+export { currentLedgerWrite, ledgerWrite } from './ledger-write.js';
+export type { ReadyItem, ScannedItem, RepoReport, ScanReport } from './scan.js';
+export { scan, scanRepoPaths, readReadyItems, readDoneSlugs } from './scan.js';
+export type { SlugNamespace, ParsedSlugArg, ResolvedSlug, ResolveSlugInput, } from './slug-namespace.js';
+export { SlugResolutionError, parseSlugArg, resolveSlug, resolveTaskOnlyArg, } from './slug-namespace.js';
+export type { RegisteredMirror, Transport, RegistryOptions, RemoteAddResult, RemoteAddOptions, RemoteRmResult, RemoteRmOptions, } from './registry.js';
+export { RegistryError, listMirrors, remoteAdd, remoteRm, transportForUrl, projectIdFromKey, } from './registry.js';
+export { formatReport, formatCwdSection, gateLabel } from './format.js';
+export type { CwdSection, CwdArbiter, ResolveCwdSectionOptions, CwdDisposition, } from './cwd-section.js';
+export { resolveCwdSection, cwdSectionDisposition } from './cwd-section.js';
+export type { TaskFolder, ResolvedTask, PromptOptions, ContinueContext, ContinueResolutionGate, } from './prompt.js';
+export { extractPromptSection, extractCanonicalWrapperTemplate, resolveProtocolDoc, wrapper, buildAgentPrompt, buildContinueBlock, extractRequeueNotes, resolveContinueContext, resolveTask, inferSlugFromBranch, renderPrompt, PromptError, } from './prompt.js';
+export type { Candidate, SelectCaps } from './select.js';
+export { selectCandidates } from './select.js';
+export type { SelectedNamespace, SelectedItem, LifecycleSelectedItem, SelectedLifecyclePools, SpecCandidate, TaskableSpecsInput, SelectPrioritisedInput, } from './select-priority.js';
+export { taskableSpecs, selectPrioritised } from './select-priority.js';
+export type { ClaimExitCode, ClaimCasOutcome, ClaimCasOptions, ClaimCasResult, } from './claim-cas.js';
+export { performClaim } from './claim-cas.js';
+export type { AcquireAdvancingLockOutcome, AcquireAdvancingLockExitCode, AcquireAdvancingLockOptions, AcquireAdvancingLockResult, ReleaseAdvancingLockOutcome, ReleaseAdvancingLockExitCode, ReleaseAdvancingLockOptions, ReleaseAdvancingLockResult, CreateItemOutcome, CreateItemExitCode, CreateItemThroughCasOptions, CreateItemThroughCasResult, CasContentionBudget, CasAttemptResult, CasContentionLoopResult, } from './advancing-lock.js';
+export { acquireAdvancingLock, releaseAdvancingLock, createItemThroughCas, nextCasContentionDelayMs, runCasContentionLoop, INTERACTIVE_CAS_CONTENTION, LIFECYCLE_CAS_CONTENTION, } from './advancing-lock.js';
+export type { LockAction, LockState, LockEntry, AcquireOutcome, ReleaseOutcome, AcquireResult, ReleaseResult, AcquireOptions, ReleaseOptions, ReconcileOutcome, ReconcileResult, ReleaseHeldOutcome, ReleaseHeldResult, LockReportEntry, ItemLockReport, } from './item-lock.js';
+export { LOCK_REF_PREFIX, lockEntryFor, itemLockRef, acquireItemLock, releaseItemLock, releaseHeldItemLock, readItemLock, reconcileItemLockAgainstMain, classifyItemLockAgainstMain, reportItemLocks, formatItemLockReport, itemLockReportNeedsAttention, itemFromLockEntry, terminalMainPaths, listItemLocks, listItemLockEntries, heldTaskSlugs, resolveLockHolder, serialiseLockEntry, parseLockEntry, } from './item-lock.js';
+export type { StartOutcome, StartOptions, StartResult } from './start.js';
+export { performStart } from './start.js';
+export type { WorkOnOutcome, WorkOnOptions, WorkOnResult } from './work-on.js';
+export { performWorkOn, suggestHumanWorktreesDir, loadHumanWorktreesDir, persistHumanWorktreesDir, } from './work-on.js';
+export type { ReadinessVerdict, ResolveReadinessOptions } from './readiness.js';
+export { resolveReadiness } from './readiness.js';
+export type { CompleteOutcome, CompleteOptions, CompleteResult, } from './complete.js';
+export { performComplete } from './complete.js';
+export type { RecoverIsolatedOutcome, RecoverIsolatedOptions, RecoverIsolatedResult, } from './recover-isolated.js';
+export { performRecoverIsolated, locateIsolatedRecovery, } from './recover-isolated.js';
+export type { DoOutcome, DoResult, DoDorfl, DoOptions, DoRemoteOptions, } from './do.js';
+export { performDo, performDoRemote } from './do.js';
+export type { DoRunner, PerformDoMultiOptions, DoMultiResult, } from './do-autopick.js';
+export { performDoAuto, performDoArgs } from './do-autopick.js';
+export type { TaskOutcome, TaskResult, TaskDorfl, TaskingLockSeam, PerformTaskOptions, } from './tasking.js';
+export { performTask } from './tasking.js';
+export type { Issue, IssueComment, GetIssueInput, ListCommentsInput, PostIssueCommentInput, PostIssueCommentResult, IssueProvider, GitHubIssueProviderOptions, } from './issue-provider.js';
+export { GitHubIssueProvider } from './issue-provider.js';
+export type { IntakeOutcome, IntakeVerdict, IntakeRunOutcome, IntakeResult, IntakeDecider, PerformIntakeOptions, } from './intake.js';
+export { performIntake, buildIntakeDecisionSpec } from './intake.js';
+export type { DecisionOutcome, DecisionVerdict, DecisionDecider, } from './decision-engine.js';
+export { decide, parseDecisionVerdict, DisallowedOutcomeError, EmptyAllowedOutcomesError, } from './decision-engine.js';
+export type { IntakeEventKind, IntakeEventDecision, IntakeEvent, } from './intake-event.js';
+export { classifyIntakeEvent } from './intake-event.js';
+export type { IntakeMarker, IntakeMarkerKind } from './intake-marker.js';
+export { stampIntakeMarker, parseIntakeMarker, isIntakeComment, computeSeenDelta, seenSetFrom, } from './intake-marker.js';
+export type { IntakeTriageDecision } from './intake-triage.js';
+export { triageIntake } from './intake-triage.js';
+export type { EnsureMirrorOptions, EnsureMirrorResult } from './repo-mirror.js';
+export { encodeRepoKey, mirrorPath, ensureMirror, fetchMirrorMain, mirrorMainSha, resolveRepoConfigFromMirror, } from './repo-mirror.js';
+export type { ScanMirrorPoolOptions, MirrorPoolScanResult, } from './mirror-pool-scan.js';
+export { scanMirrorPool } from './mirror-pool-scan.js';
+export type { LifecyclePoolGates, LifecyclePools, LifecyclePoolsInput, NeedsAnswersCandidate, ObservationCandidate, } from './lifecycle-pools.js';
+export { buildLifecyclePools } from './lifecycle-pools.js';
+export { gatherLifecycleInPlace, gatherLifecycleMirror, } from './lifecycle-gather.js';
+export type { JobRecord, JobState, CreateJobOptions, Job } from './workspace.js';
+export { JOB_RECORD_FILENAME, jobRecordPath, encodeWorkId, jobWorktreePath, createJob, writeJobRecord, readJobRecord, updateJobRecord, removeJobRecord, } from './workspace.js';
+export type { HarnessRecord, LaunchInput, LaunchResult, Harness, } from './harness.js';
+export { NullHarness, pidAlive, resolveHarness, registerHarness, } from './harness.js';
+export type { PiHarnessOptions, PiHarnessRecord } from './pi-harness.js';
+export { PiHarness, createHarness, piSessionExists, DEFAULT_PI_BIN, } from './pi-harness.js';
+export type { GenerateSessionPathInput } from './session-path.js';
+export { generateSessionPath, piDefaultSessionDir } from './session-path.js';
+export type { SessionTailerOptions } from './watch-session.js';
+export { formatWatchEvent, finishedLine, boundaryLine, SessionTailer, } from './watch-session.js';
+export type { LaunchWithOptionalWatchInput } from './agent-launch.js';
+export { launchWithOptionalWatch } from './agent-launch.js';
+export type { ReviewProvider, OpenRequestInput, OpenRequestResult, IntegrateInput, IntegrateResult, IntegrateWithRebaseResult, IntegratorOptions, RebaseInput, RebaseResult, } from './integrator.js';
+export { Integrator, NoneProvider, rebaseOntoArbiterMain, arbiterMainContains, } from './integrator.js';
+export type { ProviderName, SelectProviderOptions, GitHubProviderOptions, } from './github.js';
+export { GitHubProvider, isGitHubArbiterUrl, selectProvider, DEFAULT_GH_BIN, } from './github.js';
+export type { IsolatedTree, PrepareInput, IsolationStrategy, SelectIsolationInput, } from './isolation.js';
+export { jobWorktreeStrategy, jobWorktreeHandle, inPlaceStrategy, selectIsolationStrategy, } from './isolation.js';
+export type { ItemStatus, ItemResult, RunOnceResult, RunOnceOptions, Dorfl, } from './run.js';
+export { runOnce, defaultRunWorkspace } from './run.js';
+export type { RunVerifyOptions, RunVerifyResult } from './verify.js';
+export { runVerify, resolveVerifyCommands, DEFAULT_VERIFY_COMMAND, } from './verify.js';
+export type { PrepareConfig, RunPrepareOptions, RunPrepareResult, EnsurePreparedOptions, } from './prepare.js';
+export { runPrepare, resolvePrepareCommands, ensurePrepared, isPrepared, markPrepared, preparedMarkerPath, PREPARE_MARKER_BASENAME, } from './prepare.js';
+export type { ReviewFinding, ReviewVerdict, ReviewGateInput, ReviewGate, HarnessReviewGateOptions, } from './review-gate.js';
+export { ReviewParseError, parseReviewVerdict, buildReviewPrompt, buildTaskAcceptancePrompt, harnessReviewGate, harnessTaskAcceptanceGate, formatBlockReason, reviewRoundsExhaustedReason, } from './review-gate.js';
+export type { RetainReason, ReachableVia, SafetyVerdict, EvaluateSafetyInput, ReapInput, ReapResult, GcJob, ReapedJob, RetainedJob, GcOptions, GcResult, } from './gc.js';
+export { RETAIN_REASON_TEXT, evaluateDeletionSafety, reapJob, gc, discoverJobs, } from './gc.js';
+export type { ReapedSidecar, RetainedSidecar, SweepOrphanSidecarsInput, SweepOrphanSidecarsResult, } from './orphan-sidecar.js';
+export { sweepOrphanSidecars } from './orphan-sidecar.js';
+export type { VocabularyMigration, QuiescenceViolation, ResyncedDoc, ResyncResult, FolderMove, ContentRewrite, ConfigRewrite, RefRename, DataLeak, PrdToSpecOptions, PrdToSpecResult, } from './prd-to-spec.js';
+export { MIGRATION, PROTOCOL_DOCS, keepCaseReplace, checkQuiescence, resyncProtocol, migrateFolders, migrateItemContent, migrateAllItemContent, migrateConfig, migrateRefs, scanForLeaks, runPrdToSpec, } from './prd-to-spec.js';
+export type { JobStatus, StatusReport, StatusOptions } from './status.js';
+export { status, formatStatus } from './status.js';
+export type { ArbiterInitOptions, ArbiterInitResult, ArbiterStatusOptions, ArbiterStatusReport, } from './arbiter.js';
+export { DEFAULT_ARBITER_REMOTE, ArbiterError, arbiterPath, arbiterInit, arbiterStatus, formatArbiterStatus, } from './arbiter.js';
+export type { RouteToNeedsAttentionOptions, RouteToNeedsAttentionResult, ReturnToBacklogOptions, ReturnToBacklogResult, } from './needs-attention.js';
+export { routeToNeedsAttention, returnToBacklog, extractReason, } from './needs-attention.js';
+export type { Category, CategorisedItem, CategorisedGroups, CategorySummary, } from './categorise.js';
+export { categoriseItem, categoriseItems, sortReadyFirst, summariseGroups, CATEGORY_ORDER, CATEGORY_LABELS, } from './categorise.js';
+export type { AdvanceCiTemplateProblem, AdvanceCiTemplateValidation, } from './advance-ci-template.js';
+export { resolveAdvanceCiTemplatePath, loadAdvanceCiTemplate, validateAdvanceCiTemplate, } from './advance-ci-template.js';
+export type { CloseJobProblem, CloseJobValidation, } from './close-job-template.js';
+export { CLOSE_JOB_CAPABILITY_ID, CLOSE_JOB_CAPABILITY_LABEL, CLOSE_JOB_WORKFLOW_PATH, generateCloseJobWorkflow, validateCloseJobWorkflow, } from './close-job-template.js';
+export type { CloseDecision, CloseCandidate, CloseJobResult, CloseJobOptions, PerformCloseMergedIssuesOptions, } from './close-job.js';
+export { runCloseJob, performCloseMergedIssues } from './close-job.js';
+export type { AuthMode, ProviderEntry, CIConfigFile, ResolvedCIConfig, CIProviderContext, GitHubCIContext as GitHubCIContextType, EmittedFile, CapabilityEmitter, SecretSetResult, } from './install-ci-core.js';
+export { DEFAULT_HARNESS, CIConfigError, registerCapability, registeredCapabilities, clearCapabilityRegistry, resolveCapabilitiesDir, loadCapabilityRegistry, buildModelsJson, requiredSecretNames, optionalSecretNames, PR_IDENTITY_SECRET_NAME, providerSecretsWithBlock, orchestrateSecrets, loadCIConfigFile, resolveCIConfig, exportCIConfig, generateSetupAction, REFRESH_OAUTH_SCRIPT, buildSetupArtifacts, outputBaseName, writeArtifacts, } from './install-ci-core.js';
+export type { GitHubCIContextOptions } from './install-ci-github.js';
+export { GitHubCIContext, MemoryCIProviderContext } from './install-ci-github.js';
+export type { WizardPrompts, InstallCIOptions, InstallCIResult, } from './install-ci.js';
+export { installCI, runWizard } from './install-ci.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,76 @@
+export { BASE, brand, deriveBrand, paramCase, constantCase } from './brand.js';
+export { DEFAULT_CONFIG, mergeConfig, loadConfig, saveConfig, defaultConfigPath, } from './config.js';
+export { REPO_CONFIG_FILENAME, REPO_ALLOWED_KEYS, REPO_REJECTED_KEYS, repoConfigPath, loadRepoConfig, resolveRepoConfig, } from './repo-config.js';
+export { defaultConfigOverridePath, loadConfigOverride, } from './config-override.js';
+export { ENV_PREFIX, envVarName, envOverrides } from './env-config.js';
+export { renderTaskBody, renderSpecBody } from './buildable-body.js';
+export { parseFrontmatter, setNeedsAnswersMarker, setFrontmatterMarker, } from './frontmatter.js';
+export { SidecarParseError, isEntryAnswered, pendingEntries, allAnswered, resolveSidecarIdentity, sidecarPathFor, sidecarPathCandidates, parseSidecar, serialiseSidecar, appendQuestions, newSidecar, } from './sidecar.js';
+export { ApplyAtomicError, applyAtomic } from './sidecar-apply.js';
+export { ApplyPersistError, applyAnsweredQuestions } from './apply-persist.js';
+export { MintAdrError, mintAdr, buildAdrBody, adrItemRel } from './mint-adr.js';
+export { APPLY_LIFECYCLE_FOLDERS, resolveItemPathByIdentity, } from './item-path.js';
+export { DropSourceError, dropSource } from './drop-source.js';
+export { classifyTick, isAdvanceable } from './advance-classify.js';
+export { isParticipatingRepo, findParticipatingRepos } from './detect.js';
+export { resolveGate, resolveBlockedBy, resolveEligibility, } from './eligibility.js';
+export { resolveTaskGate, resolveTaskedAfter, resolveTaskingEligibility, } from './tasking-eligibility.js';
+export { currentLedgerRead, ledgerRead } from './ledger-read.js';
+export { isSpecComplete } from './spec-complete.js';
+export { currentLedgerWrite, ledgerWrite } from './ledger-write.js';
+export { scan, scanRepoPaths, readReadyItems, readDoneSlugs } from './scan.js';
+export { SlugResolutionError, parseSlugArg, resolveSlug, resolveTaskOnlyArg, } from './slug-namespace.js';
+export { RegistryError, listMirrors, remoteAdd, remoteRm, transportForUrl, projectIdFromKey, } from './registry.js';
+export { formatReport, formatCwdSection, gateLabel } from './format.js';
+export { resolveCwdSection, cwdSectionDisposition } from './cwd-section.js';
+export { extractPromptSection, extractCanonicalWrapperTemplate, resolveProtocolDoc, wrapper, buildAgentPrompt, buildContinueBlock, extractRequeueNotes, resolveContinueContext, resolveTask, inferSlugFromBranch, renderPrompt, PromptError, } from './prompt.js';
+export { selectCandidates } from './select.js';
+export { taskableSpecs, selectPrioritised } from './select-priority.js';
+export { performClaim } from './claim-cas.js';
+export { acquireAdvancingLock, releaseAdvancingLock, createItemThroughCas, nextCasContentionDelayMs, runCasContentionLoop, INTERACTIVE_CAS_CONTENTION, LIFECYCLE_CAS_CONTENTION, } from './advancing-lock.js';
+export { LOCK_REF_PREFIX, lockEntryFor, itemLockRef, acquireItemLock, releaseItemLock, releaseHeldItemLock, readItemLock, reconcileItemLockAgainstMain, classifyItemLockAgainstMain, reportItemLocks, formatItemLockReport, itemLockReportNeedsAttention, itemFromLockEntry, terminalMainPaths, listItemLocks, listItemLockEntries, heldTaskSlugs, resolveLockHolder, serialiseLockEntry, parseLockEntry, } from './item-lock.js';
+export { performStart } from './start.js';
+export { performWorkOn, suggestHumanWorktreesDir, loadHumanWorktreesDir, persistHumanWorktreesDir, } from './work-on.js';
+export { resolveReadiness } from './readiness.js';
+export { performComplete } from './complete.js';
+export { performRecoverIsolated, locateIsolatedRecovery, } from './recover-isolated.js';
+export { performDo, performDoRemote } from './do.js';
+export { performDoAuto, performDoArgs } from './do-autopick.js';
+export { performTask } from './tasking.js';
+export { GitHubIssueProvider } from './issue-provider.js';
+export { performIntake, buildIntakeDecisionSpec } from './intake.js';
+export { decide, parseDecisionVerdict, DisallowedOutcomeError, EmptyAllowedOutcomesError, } from './decision-engine.js';
+export { classifyIntakeEvent } from './intake-event.js';
+export { stampIntakeMarker, parseIntakeMarker, isIntakeComment, computeSeenDelta, seenSetFrom, } from './intake-marker.js';
+export { triageIntake } from './intake-triage.js';
+export { encodeRepoKey, mirrorPath, ensureMirror, fetchMirrorMain, mirrorMainSha, resolveRepoConfigFromMirror, } from './repo-mirror.js';
+export { scanMirrorPool } from './mirror-pool-scan.js';
+export { buildLifecyclePools } from './lifecycle-pools.js';
+export { gatherLifecycleInPlace, gatherLifecycleMirror, } from './lifecycle-gather.js';
+export { JOB_RECORD_FILENAME, jobRecordPath, encodeWorkId, jobWorktreePath, createJob, writeJobRecord, readJobRecord, updateJobRecord, removeJobRecord, } from './workspace.js';
+export { NullHarness, pidAlive, resolveHarness, registerHarness, } from './harness.js';
+export { PiHarness, createHarness, piSessionExists, DEFAULT_PI_BIN, } from './pi-harness.js';
+export { generateSessionPath, piDefaultSessionDir } from './session-path.js';
+export { formatWatchEvent, finishedLine, boundaryLine, SessionTailer, } from './watch-session.js';
+export { launchWithOptionalWatch } from './agent-launch.js';
+export { Integrator, NoneProvider, rebaseOntoArbiterMain, arbiterMainContains, } from './integrator.js';
+export { GitHubProvider, isGitHubArbiterUrl, selectProvider, DEFAULT_GH_BIN, } from './github.js';
+export { jobWorktreeStrategy, jobWorktreeHandle, inPlaceStrategy, selectIsolationStrategy, } from './isolation.js';
+export { runOnce, defaultRunWorkspace } from './run.js';
+export { runVerify, resolveVerifyCommands, DEFAULT_VERIFY_COMMAND, } from './verify.js';
+export { runPrepare, resolvePrepareCommands, ensurePrepared, isPrepared, markPrepared, preparedMarkerPath, PREPARE_MARKER_BASENAME, } from './prepare.js';
+export { ReviewParseError, parseReviewVerdict, buildReviewPrompt, buildTaskAcceptancePrompt, harnessReviewGate, harnessTaskAcceptanceGate, formatBlockReason, reviewRoundsExhaustedReason, } from './review-gate.js';
+export { RETAIN_REASON_TEXT, evaluateDeletionSafety, reapJob, gc, discoverJobs, } from './gc.js';
+export { sweepOrphanSidecars } from './orphan-sidecar.js';
+export { MIGRATION, PROTOCOL_DOCS, keepCaseReplace, checkQuiescence, resyncProtocol, migrateFolders, migrateItemContent, migrateAllItemContent, migrateConfig, migrateRefs, scanForLeaks, runPrdToSpec, } from './prd-to-spec.js';
+export { status, formatStatus } from './status.js';
+export { DEFAULT_ARBITER_REMOTE, ArbiterError, arbiterPath, arbiterInit, arbiterStatus, formatArbiterStatus, } from './arbiter.js';
+export { routeToNeedsAttention, returnToBacklog, extractReason, } from './needs-attention.js';
+export { categoriseItem, categoriseItems, sortReadyFirst, summariseGroups, CATEGORY_ORDER, CATEGORY_LABELS, } from './categorise.js';
+export { resolveAdvanceCiTemplatePath, loadAdvanceCiTemplate, validateAdvanceCiTemplate, } from './advance-ci-template.js';
+export { CLOSE_JOB_CAPABILITY_ID, CLOSE_JOB_CAPABILITY_LABEL, CLOSE_JOB_WORKFLOW_PATH, generateCloseJobWorkflow, validateCloseJobWorkflow, } from './close-job-template.js';
+export { runCloseJob, performCloseMergedIssues } from './close-job.js';
+export { DEFAULT_HARNESS, CIConfigError, registerCapability, registeredCapabilities, clearCapabilityRegistry, resolveCapabilitiesDir, loadCapabilityRegistry, buildModelsJson, requiredSecretNames, optionalSecretNames, PR_IDENTITY_SECRET_NAME, providerSecretsWithBlock, orchestrateSecrets, loadCIConfigFile, resolveCIConfig, exportCIConfig, generateSetupAction, REFRESH_OAUTH_SCRIPT, buildSetupArtifacts, outputBaseName, writeArtifacts, } from './install-ci-core.js';
+export { GitHubCIContext, MemoryCIProviderContext } from './install-ci-github.js';
+export { installCI, runWizard } from './install-ci.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/install-ci-branch-protection.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Tier-1 GitHub branch-protection STEP for `install-ci` (prd
+ * `land-time-reverify-and-parallel-merge-ceiling`, task
+ * `install-ci-tier1-branch-protection`; Story 11). Closes the propose-mode
+ * PR-merge-time drift window on a GitHub arbiter: a required `verify` check + a
+ * `strict: true` ("require branches up to date before merging") rule together
+ * force a rebase + re-verify against current `main` before the merge button works.
+ *
+ * BEHAVIOUR (Applied Answer / Implementation Decision, spec §"Implementation
+ * Decisions" — Tier-1 GitHub provisioning is auto-when-admin, instruct-otherwise):
+ *
+ *   - When the configured credential is repo-admin-scoped, install-ci
+ *     AUTO-CONFIGURES branch protection on `main` with the spec built by
+ *     {@link buildBranchProtectionSpec}. The required `context` value
+ *     ({@link VERIFY_CHECK_CONTEXT}) is the SAME constant the emitted verify
+ *     workflow names its job after, so the two cannot drift.
+ *   - When only the ambient `GITHUB_TOKEN` (or any non-admin credential) is
+ *     available, install-ci NEVER attempts the call — it PRINTS the exact
+ *     ready-to-run `gh api` command + a one-liner pointing to the manual UI
+ *     fallback (the documented behaviour the spec fixes at launch).
+ *
+ * SCOPE DETECTION — cheapest of the two options the spec offers. The seam
+ * provides `getRepoAdminScope?()` (implemented on the GitHub adapter by reading
+ * `permissions.admin` from `GET /repos/{owner}/{repo}` — ONE low-cost read that
+ * works uniformly for every token kind: classic PAT, fine-grained PAT, GitHub
+ * App, or the ambient `GITHUB_TOKEN`). The ALTERNATIVE — reading the token's
+ * DOCUMENTED METADATA — varies by token type (a classic PAT exposes its scopes
+ * via the `X-OAuth-Scopes` response header; a fine-grained PAT exposes its
+ * resource permissions via a separate endpoint; a GitHub App exposes nothing
+ * inspectable from the runtime) and so would mean three code paths and the same
+ * number of round-trips at best. ONE uniform repo-permissions read is therefore
+ * the cheaper choice on both implementation effort AND wall-clock (a single API
+ * call against an endpoint every token can hit). RECORDED IN-PLACE so a future
+ * change can flip it knowingly; the spec calls this "pick the cheaper of the
+ * two and record the choice."
+ *
+ * DEADLOCK GUARD — a NEVER-RUN required check would block every merge (GitHub
+ * treats an unreported required check as pending). install-ci ORDERS the steps
+ * to avoid that:
+ *
+ *   1. write the verify workflow artifact (the `verify.yml` whose job is named
+ *      exactly {@link VERIFY_CHECK_CONTEXT}); the human commits + pushes it to
+ *      `main` so the workflow file lands BEFORE the next PR;
+ *   2. THEN (this step) set the branch-protection rule.
+ *
+ * Because the verify workflow uses `on: pull_request`, every PR opened AFTER
+ * `verify.yml` is on `main` triggers the workflow and produces the required
+ * `verify` check — the protection never deadlocks new PRs. The only edge case
+ * is an IN-FLIGHT PR opened BEFORE `verify.yml` landed on `main`: it has no
+ * `verify` check waiting; installCI prints exactly that re-trigger remediation
+ * in the success log. We chose this "run-the-check-once-by-construction-of-the-
+ * trigger" ordering over the ruleset `do_not_enforce_on_create` toggle because
+ * (a) one PUT against the existing branch-protection endpoint is simpler than
+ * minting a ruleset shape this spec otherwise does not need, AND (b) the
+ * `merge_queue` Tier-2 forward seam already lives in the verify workflow's
+ * `on:` trigger (so the ruleset seam is not needed here either — it is the
+ * follow-on spec's lever). Trade-off RECORDED so a future merge-queue task can
+ * flip to rulesets knowingly without re-deciding why we did not now.
+ */
+import { VERIFY_CHECK_CONTEXT } from './verify-workflow-template.js';
+import type { CIProviderContext } from './install-ci-core.js';
+export { VERIFY_CHECK_CONTEXT };
+/**
+ * The branch-protection request body the GitHub adapter PUTs at
+ * `/repos/{owner}/{repo}/branches/{branch}/protection`. Shape mirrors the REST
+ * docs (the GitHub PUT REQUIRES `enforce_admins`, `required_pull_request_reviews`,
+ * and `restrictions` to be present; `null` for "not configured"). We set only
+ * the two fields the spec names — the required `${VERIFY_CHECK_CONTEXT}` check
+ * AND `strict: true` (= "require branches up to date before merging") — and
+ * leave the others `null` so install-ci does not silently impose unrelated
+ * gates (reviews, admin enforcement, push restrictions) the user did not opt
+ * into.
+ */
+export interface BranchProtectionSpec {
+    required_status_checks: {
+        strict: true;
+        checks: {
+            context: string;
+        }[];
+    };
+    enforce_admins: null;
+    required_pull_request_reviews: null;
+    restrictions: null;
+}
+/**
+ * Build the Tier-1 branch-protection spec the GitHub adapter PUTs. The required
+ * `context` is the SAME constant the emitted verify workflow names its job
+ * after ({@link VERIFY_CHECK_CONTEXT}) — by construction, not by hand-typed
+ * agreement, so the two cannot drift.
+ */
+export declare function buildBranchProtectionSpec(): BranchProtectionSpec;
+/**
+ * The repo's default branch the protection rule targets (the rule the spec
+ * names: protect `main` so a propose-mode PR cannot be merged stale). Exposed
+ * as a parameter on the orchestrator so a non-default-branch repo can override.
+ */
+export declare const DEFAULT_PROTECTED_BRANCH = "main";
+/**
+ * The exact `gh api` command the user runs themselves when install-ci CANNOT
+ * auto-configure (no admin scope). Quoted body is the same {@link
+ * BranchProtectionSpec} the auto path PUTs, so reproducing the call by copy-paste
+ * is byte-equivalent to a successful auto run. Pure string, no I/O.
+ */
+export declare function formatManualBranchProtectionCommand(repo: string, branch?: string): string;
+/** Options for {@link installCIBranchProtectionStep}. */
+export interface BranchProtectionStepOptions {
+    /** The CI-provider seam (GitHub adapter in production; stub in tests). */
+    ctx: CIProviderContext;
+    /** Snapshot mode: never call the live API, never print a "set" success. */
+    fake?: boolean;
+    /** Sink for human-facing progress lines. */
+    log: (line: string) => void;
+    /** The branch the rule targets (default `main`). */
+    branch?: string;
+}
+/** The outcome of one branch-protection step run. */
+export interface BranchProtectionStepResult {
+    /**
+     * - `set` — admin scope, API call succeeded;
+     * - `failed` — admin scope, API call rejected (detail in `error`);
+     * - `instructed` — non-admin scope, the manual `gh api` command was printed;
+     * - `skipped-no-repo` — the provider context has no `repo` known;
+     * - `skipped-no-seam` — the provider context does not implement the
+     *   branch-protection seam (a non-GitHub provider);
+     * - `skipped-fake` — `--fake` snapshot mode (no real API, no real toggle).
+     */
+    status: 'set' | 'failed' | 'instructed' | 'skipped-no-repo' | 'skipped-no-seam' | 'skipped-fake';
+    /** The detected admin-scope verdict (`true`/`false`/`undefined`=unknown). */
+    adminScope?: boolean;
+    /** The failure detail when `status === 'failed'`. */
+    error?: string;
+    /** The branch the step targeted (echoed for tests / logs). */
+    branch: string;
+}
+/**
+ * The orchestrator install-ci calls AFTER artifacts are written + secrets are
+ * orchestrated: detect admin scope (cheapest path: {@link
+ * CIProviderContext.getRepoAdminScope}), then EITHER call
+ * {@link CIProviderContext.setBranchProtection} (admin) OR print the exact
+ * ready-to-run `gh api` command + the one-liner manual fallback (non-admin).
+ *
+ * Never throws — a `setBranchProtection` rejection is reported as `failed` so
+ * install-ci's later steps still run, and the user sees both the failure detail
+ * AND the manual command to retry by hand.
+ */
+export declare function installCIBranchProtectionStep(options: BranchProtectionStepOptions): Promise<BranchProtectionStepResult>;
+//# sourceMappingURL=install-ci-branch-protection.d.ts.map

package/dist/install-ci-branch-protection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ci-branch-protection.d.ts","sourceRoot":"","sources":["../src/install-ci-branch-protection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,OAAO,EAAC,oBAAoB,EAAC,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAC,oBAAoB,EAAC,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACpC,sBAAsB,EAAE;QACvB,MAAM,EAAE,IAAI,CAAC;QACb,MAAM,EAAE;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;KAC5B,CAAC;IACF,cAAc,EAAE,IAAI,CAAC;IACrB,6BAA6B,EAAE,IAAI,CAAC;IACpC,YAAY,EAAE,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,CAUhE;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAClD,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAiC,GACvC,MAAM,CAYR;AAED,yDAAyD;AACzD,MAAM,WAAW,2BAA2B;IAC3C,0EAA0E;IAC1E,GAAG,EAAE,iBAAiB,CAAC;IACvB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;;OAQG;IACH,MAAM,EACH,KAAK,GACL,QAAQ,GACR,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CAClD,OAAO,EAAE,2BAA2B,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAqErC"}

package/dist/install-ci-branch-protection.js

@@ -0,0 +1,166 @@
+/**
+ * Tier-1 GitHub branch-protection STEP for `install-ci` (prd
+ * `land-time-reverify-and-parallel-merge-ceiling`, task
+ * `install-ci-tier1-branch-protection`; Story 11). Closes the propose-mode
+ * PR-merge-time drift window on a GitHub arbiter: a required `verify` check + a
+ * `strict: true` ("require branches up to date before merging") rule together
+ * force a rebase + re-verify against current `main` before the merge button works.
+ *
+ * BEHAVIOUR (Applied Answer / Implementation Decision, spec §"Implementation
+ * Decisions" — Tier-1 GitHub provisioning is auto-when-admin, instruct-otherwise):
+ *
+ *   - When the configured credential is repo-admin-scoped, install-ci
+ *     AUTO-CONFIGURES branch protection on `main` with the spec built by
+ *     {@link buildBranchProtectionSpec}. The required `context` value
+ *     ({@link VERIFY_CHECK_CONTEXT}) is the SAME constant the emitted verify
+ *     workflow names its job after, so the two cannot drift.
+ *   - When only the ambient `GITHUB_TOKEN` (or any non-admin credential) is
+ *     available, install-ci NEVER attempts the call — it PRINTS the exact
+ *     ready-to-run `gh api` command + a one-liner pointing to the manual UI
+ *     fallback (the documented behaviour the spec fixes at launch).
+ *
+ * SCOPE DETECTION — cheapest of the two options the spec offers. The seam
+ * provides `getRepoAdminScope?()` (implemented on the GitHub adapter by reading
+ * `permissions.admin` from `GET /repos/{owner}/{repo}` — ONE low-cost read that
+ * works uniformly for every token kind: classic PAT, fine-grained PAT, GitHub
+ * App, or the ambient `GITHUB_TOKEN`). The ALTERNATIVE — reading the token's
+ * DOCUMENTED METADATA — varies by token type (a classic PAT exposes its scopes
+ * via the `X-OAuth-Scopes` response header; a fine-grained PAT exposes its
+ * resource permissions via a separate endpoint; a GitHub App exposes nothing
+ * inspectable from the runtime) and so would mean three code paths and the same
+ * number of round-trips at best. ONE uniform repo-permissions read is therefore
+ * the cheaper choice on both implementation effort AND wall-clock (a single API
+ * call against an endpoint every token can hit). RECORDED IN-PLACE so a future
+ * change can flip it knowingly; the spec calls this "pick the cheaper of the
+ * two and record the choice."
+ *
+ * DEADLOCK GUARD — a NEVER-RUN required check would block every merge (GitHub
+ * treats an unreported required check as pending). install-ci ORDERS the steps
+ * to avoid that:
+ *
+ *   1. write the verify workflow artifact (the `verify.yml` whose job is named
+ *      exactly {@link VERIFY_CHECK_CONTEXT}); the human commits + pushes it to
+ *      `main` so the workflow file lands BEFORE the next PR;
+ *   2. THEN (this step) set the branch-protection rule.
+ *
+ * Because the verify workflow uses `on: pull_request`, every PR opened AFTER
+ * `verify.yml` is on `main` triggers the workflow and produces the required
+ * `verify` check — the protection never deadlocks new PRs. The only edge case
+ * is an IN-FLIGHT PR opened BEFORE `verify.yml` landed on `main`: it has no
+ * `verify` check waiting; installCI prints exactly that re-trigger remediation
+ * in the success log. We chose this "run-the-check-once-by-construction-of-the-
+ * trigger" ordering over the ruleset `do_not_enforce_on_create` toggle because
+ * (a) one PUT against the existing branch-protection endpoint is simpler than
+ * minting a ruleset shape this spec otherwise does not need, AND (b) the
+ * `merge_queue` Tier-2 forward seam already lives in the verify workflow's
+ * `on:` trigger (so the ruleset seam is not needed here either — it is the
+ * follow-on spec's lever). Trade-off RECORDED so a future merge-queue task can
+ * flip to rulesets knowingly without re-deciding why we did not now.
+ */
+import { VERIFY_CHECK_CONTEXT } from './verify-workflow-template.js';
+export { VERIFY_CHECK_CONTEXT };
+/**
+ * Build the Tier-1 branch-protection spec the GitHub adapter PUTs. The required
+ * `context` is the SAME constant the emitted verify workflow names its job
+ * after ({@link VERIFY_CHECK_CONTEXT}) — by construction, not by hand-typed
+ * agreement, so the two cannot drift.
+ */
+export function buildBranchProtectionSpec() {
+    return {
+        required_status_checks: {
+            strict: true,
+            checks: [{ context: VERIFY_CHECK_CONTEXT }],
+        },
+        enforce_admins: null,
+        required_pull_request_reviews: null,
+        restrictions: null,
+    };
+}
+/**
+ * The repo's default branch the protection rule targets (the rule the spec
+ * names: protect `main` so a propose-mode PR cannot be merged stale). Exposed
+ * as a parameter on the orchestrator so a non-default-branch repo can override.
+ */
+export const DEFAULT_PROTECTED_BRANCH = 'main';
+/**
+ * The exact `gh api` command the user runs themselves when install-ci CANNOT
+ * auto-configure (no admin scope). Quoted body is the same {@link
+ * BranchProtectionSpec} the auto path PUTs, so reproducing the call by copy-paste
+ * is byte-equivalent to a successful auto run. Pure string, no I/O.
+ */
+export function formatManualBranchProtectionCommand(repo, branch = DEFAULT_PROTECTED_BRANCH) {
+    const spec = buildBranchProtectionSpec();
+    const body = JSON.stringify(spec);
+    // Single-quote the body so the user's shell does not expand `$`/`!`; embed
+    // it via `--input -` so the JSON is read from stdin (avoids `gh api -f`'s
+    // scalar-only field syntax limitation).
+    return (`echo '${body}' | gh api -X PUT ` +
+        `-H "Accept: application/vnd.github+json" ` +
+        `repos/${repo}/branches/${branch}/protection ` +
+        `--input -`);
+}
+/**
+ * The orchestrator install-ci calls AFTER artifacts are written + secrets are
+ * orchestrated: detect admin scope (cheapest path: {@link
+ * CIProviderContext.getRepoAdminScope}), then EITHER call
+ * {@link CIProviderContext.setBranchProtection} (admin) OR print the exact
+ * ready-to-run `gh api` command + the one-liner manual fallback (non-admin).
+ *
+ * Never throws — a `setBranchProtection` rejection is reported as `failed` so
+ * install-ci's later steps still run, and the user sees both the failure detail
+ * AND the manual command to retry by hand.
+ */
+export async function installCIBranchProtectionStep(options) {
+    const branch = options.branch ?? DEFAULT_PROTECTED_BRANCH;
+    const { ctx, log, fake } = options;
+    if (fake) {
+        log(`branch protection: skipped (--fake; would have targeted ${branch})`);
+        return { status: 'skipped-fake', branch };
+    }
+    if (!ctx.setBranchProtection) {
+        log('branch protection: skipped (provider does not implement the seam — non-GitHub host).');
+        return { status: 'skipped-no-seam', branch };
+    }
+    if (!ctx.repo) {
+        log('branch protection: skipped (repo unknown — pass --repo to enable).');
+        return { status: 'skipped-no-repo', branch };
+    }
+    const repo = ctx.repo;
+    // Cheapest scope-detection: one repo-permissions read (see module header).
+    // `undefined` ⇒ unknown ⇒ treat as non-admin (instruct, never silently
+    // attempt a call that would fail with 403 anyway).
+    const adminScope = ctx.getRepoAdminScope
+        ? await ctx.getRepoAdminScope().catch(() => undefined)
+        : undefined;
+    if (adminScope !== true) {
+        log('branch protection: no admin-scoped credential detected.');
+        log(`  install-ci will NOT call the GitHub API. Run this yourself (admin token required):`);
+        log(`    ${formatManualBranchProtectionCommand(repo, branch)}`);
+        log(`  Manual UI fallback: https://github.com/${repo}/settings/branches ` +
+            `→ "Add branch protection rule" → branch name pattern \`${branch}\` ` +
+            `→ enable "Require status checks to pass" + "Require branches to be up to date" ` +
+            `→ add required check \`${VERIFY_CHECK_CONTEXT}\`.`);
+        log(`  (The ambient CI \`GITHUB_TOKEN\` is NEVER admin; a human admin's \`gh\` ` +
+            `or a configured PAT/App token with "Administration: write" is required.)`);
+        return { status: 'instructed', adminScope, branch };
+    }
+    const spec = buildBranchProtectionSpec();
+    try {
+        await ctx.setBranchProtection(branch, spec);
+        log(`branch protection: set on ${repo}@${branch} ` +
+            `(required check \`${VERIFY_CHECK_CONTEXT}\`, strict: true).`);
+        log(`  NOTE: PRs opened BEFORE \`verify.yml\` lands on \`${branch}\` have ` +
+            `no \`${VERIFY_CHECK_CONTEXT}\` check waiting. Push/merge \`verify.yml\` ` +
+            `to \`${branch}\` first; existing in-flight PRs may need a no-op push ` +
+            `(or close/reopen) to re-trigger the check.`);
+        return { status: 'set', adminScope, branch };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        log(`branch protection: FAILED (${error})`);
+        log(`  Retry by hand (admin token required):\n` +
+            `    ${formatManualBranchProtectionCommand(repo, branch)}`);
+        return { status: 'failed', adminScope, error, branch };
+    }
+}
+//# sourceMappingURL=install-ci-branch-protection.js.map

package/dist/install-ci-branch-protection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ci-branch-protection.js","sourceRoot":"","sources":["../src/install-ci-branch-protection.ts"],"names":[],"mappings":"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"}

package/dist/install-ci-capabilities/advance-lifecycle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The ADVANCE-LIFECYCLE capability emitter (PRD `runner-in-ci`, task
+ * `install-ci-advance-lifecycle-workflow`; capability C: auto-triage observations
+ * + surface declared blockers + apply committed answers). A SELF-REGISTERING
+ * module: it calls {@link registerCapability} at import time, so
+ * {@link loadCapabilityRegistry} picks it up WITHOUT any edit to a shared central
+ * list/switch (the file-orthogonality contract — this task and the sibling
+ * capability tasks stay mergeable in parallel).
+ *
+ * The workflow shape (the parameterised seed `advance-loop.yml.template`) + its
+ * structural validator live in `advance-lifecycle-template.ts`; this file is the
+ * thin registry-wiring shim.
+ */
+export {};
+//# sourceMappingURL=advance-lifecycle.d.ts.map

package/dist/install-ci-capabilities/advance-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance-lifecycle.d.ts","sourceRoot":"","sources":["../../src/install-ci-capabilities/advance-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}