yet-another-agentic-workflow 0.2.0

package/dist/feature.js

@@ -0,0 +1,344 @@
+import { join, resolve } from "node:path";
+import { loadAndValidateProjectDefinition } from "./parser.js";
+import { invokeSkill } from "./skills.js";
+export class FeatureWorkflowError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FeatureWorkflowError";
+    }
+}
+const SKILL_DOCUMENTS = {
+    clarify: `---
+name: clarify
+purpose: Resolve consequential ambiguity before implementation.
+description: Resolve only the unknowns that materially change behavior, scope, or the public testing seam.
+dependencies: []
+---
+# Clarify
+
+Resolve ambiguity from evidence before asking questions.
+
+1. Read the request, relevant conversation, repository instructions, domain documentation, ADRs, code, and nearby tests. Use the project's domain vocabulary.
+2. Separate facts that the repository can answer from unknowns that change observable behavior, scope, data contracts, or irreversible decisions.
+3. State the requested user-visible outcome and identify the highest existing public seam through which it can be verified. Prefer an existing seam; propose a new one only when the behavior cannot be observed otherwise.
+4. Ask one focused question only when competing answers would produce meaningfully different implementations and no repository evidence resolves them. Otherwise record the smallest reasonable assumption.
+5. Produce resolved decisions, assumptions, the selected public seam, remaining unknowns, and the next action. Stop when specification work is unblocked.
+`,
+    spec: `---
+name: spec
+purpose: Convert a resolved request into a concise, durable behavioral specification.
+description: Synthesize repository evidence and resolved decisions into behavior, seams, and independently verifiable acceptance criteria.
+dependencies: [clarify]
+---
+# Specification
+
+Synthesize what is already known; do not restart the requirements interview. Use repository domain vocabulary and respect applicable ADRs.
+
+## Required specification
+
+- **Problem and goal:** the user's problem and the outcome that resolves it.
+- **User-visible solution:** numbered user stories or scenarios that describe actors, behavior, and benefit.
+- **Expected behavior:** normal flow, consequential failure states, and externally visible state transitions.
+- **Implementation decisions:** durable contracts, schema or API decisions, and architectural constraints. Avoid speculative file paths and code snippets.
+- **Testing decisions:** select the highest existing public seam that can prove the behavior, name prior test patterns to follow, and justify any new seam.
+- **Constraints and non-goals:** explicit boundaries that prevent scope drift.
+- **Acceptance criteria:** independently verifiable observations with an unambiguous source of truth.
+- **Important decisions and unknowns:** preserve rationale and identify only unresolved items that can still change delivery.
+
+Prefer fewer, higher-leverage seams. Tests should observe behavior through public interfaces and remain valid when internals are refactored.
+`,
+    "slice-work": `---
+name: slice-work
+purpose: Divide a specification into independently verifiable vertical slices.
+description: Turn a specification into tracer-bullet slices with acceptance criteria, testing seams, and explicit blocking edges.
+dependencies: [spec]
+---
+# Slice work
+
+Build a dependency graph of tracer-bullet vertical slices, not a layer-by-layer task list.
+
+1. Make each slice deliver one narrow but complete user-visible behavior through every relevant layer. A completed slice must be demonstrable or verifiable on its own and fit within one fresh working context.
+2. Give each slice an ID, title, delivered behavior, acceptance criteria, public verification seam, verification command or method, and \`blockedBy\` IDs.
+3. Keep blocking edges real: a slice depends only on work that must exist before it can start. Order blockers first and identify the current frontier—all slices whose blockers are complete.
+4. Prefer the smallest end-to-end slice first. Add a prefactoring slice only when it independently keeps verification green and materially makes the behavior change easier.
+5. Treat wide mechanical refactors as the exception. Use expand–contract: add the new form beside the old, migrate bounded batches while verification stays green, then remove the old form after all migrations.
+6. Avoid predicted file paths and speculative implementation detail. Preserve the specification's domain language and observable boundaries.
+`,
+    tdd: `---
+name: tdd
+purpose: Implement behavior through a failing test, the smallest passing change, and refactoring.
+description: Deliver one vertical slice at a time with public-interface tests, boundary-only mocks, and recorded red-green evidence.
+dependencies: []
+---
+# Test-driven development
+
+Work one acceptance criterion and one pre-agreed public seam at a time. Read relevant domain documentation and ADRs so test names and interfaces use repository language.
+
+## Test quality
+
+- Verify behavior through the public interface at the selected seam. Tests should survive internal refactoring and read as executable specifications.
+- Derive expected results from an independent source of truth: a known literal, worked example, contract, or acceptance criterion.
+- Avoid **implementation-coupled** tests of private methods, internal collaborators, call order, or incidental storage.
+- Avoid **tautological** assertions that recompute the result with the same logic as production code.
+- Mock only at system boundaries such as external APIs, time, randomness, or an unavailable external store. Prefer real controlled dependencies and never mock code the project owns merely to make a test easy.
+
+## Red-green-refactor cycle
+
+1. Confirm the active criterion and public seam. Write one focused behavioral test.
+2. Run it and record RED: exact command, relevant failure, and non-zero status. A test that passes immediately does not prove the change.
+3. Implement the smallest production change that produces GREEN. Do not anticipate later slices or add speculative generality.
+4. Run the focused test and record GREEN. Refactor only the code exercised by the slice, without changing behavior, and keep the focused test green.
+5. Repeat with the next behavior learned from the previous cycle; do not write a horizontal batch of imagined tests up front.
+6. Run relevant typechecking and focused tests during work, then the full required verification suite once the slice is complete. Record commands, outputs, and exit statuses.
+`,
+    "code-review": `---
+name: code-review
+purpose: Review an implementation against one explicit axis using repository evidence.
+description: Review a fixed change set against either the specification or engineering standards without letting one axis mask the other.
+dependencies: []
+---
+# Code review
+
+Review one axis only. The workflow invokes separate spec and standards reviewers so their evidence and verdicts remain independent.
+
+## Establish the review set
+
+1. Pin the fixed point from the supplied diff, commit, branch, transaction artifact, or persisted workflow record. Confirm that the change set is non-empty.
+2. Inspect changed code and recorded verification evidence. Do not expand the review into unrelated pre-existing code.
+3. Load only the evidence for the assigned axis.
+
+## Spec axis
+
+Compare the change with the originating specification and acceptance criteria. Find missing or partial behavior, behavior that appears implemented incorrectly, and unrequested scope creep. Cite the criterion and changed file or hunk for every finding. If no specification exists, report that the axis was not assessable rather than inventing requirements.
+
+## Standards axis
+
+Apply documented repository standards first; they override generic heuristics. Then use this compact smell baseline as judgement, not automatic failure: mysterious names, duplicated logic, data clumps or primitive obsession, repeated conditionals, shotgun surgery or divergent change, speculative generality, message chains, and middle-man abstractions. Skip concerns already enforced by successful tooling.
+
+## Verdict
+
+- Report each finding with a stable code, severity, file or hunk, evidence, and the smallest corrective direction.
+- Distinguish documented violations from judgement calls.
+- Return explicit \`PASS\` with no findings, or \`FAIL\` with at least one evidence-backed finding.
+- Remain read-only: do not repair the implementation from the reviewer role.
+`
+};
+/** Return the official Phase 4 feature workflow and all primitives it requires. */
+export function createOfficialFeaturePrimitives(verificationCommands, context = []) {
+    const commands = verificationCommands.length
+        ? [...verificationCommands]
+        : ["REPLACE_WITH_VERIFICATION_COMMAND"];
+    const contextNames = context.map(({ name }) => name);
+    const skills = [
+        {
+            name: "clarify",
+            purpose: "Resolve consequential ambiguity before implementation.",
+            steps: ["inspect evidence", "resolve repository facts", "select public seam", "record decisions and assumptions"]
+        },
+        {
+            name: "spec",
+            purpose: "Turn resolved requirements into observable acceptance criteria.",
+            steps: ["state problem and user-visible solution", "define behavior and contracts", "select testing seams", "write acceptance criteria and non-goals"],
+            dependencies: ["clarify"]
+        },
+        {
+            name: "slice-work",
+            purpose: "Divide a specification into independently verifiable vertical slices.",
+            steps: ["draft tracer bullets", "define slice criteria and seams", "map blocking edges", "identify the frontier"],
+            dependencies: ["spec"]
+        },
+        {
+            name: "tdd",
+            purpose: "Implement behavior with a red-green-refactor feedback loop.",
+            steps: ["test through the public seam", "confirm red", "implement minimum change", "confirm green", "refactor and verify"]
+        },
+        {
+            name: "code-review",
+            purpose: "Review an implementation against one explicit axis using evidence.",
+            steps: ["pin the change set", "select one review axis", "inspect axis evidence", "report evidence-backed findings or pass"]
+        }
+    ];
+    const agents = [
+        {
+            name: "worker",
+            objective: "Implement one independently verifiable vertical slice.",
+            permissions: { filesystem: "read-write", shell: "execute", network: false },
+            context: contextNames,
+            skills: ["tdd"],
+            tools: ["filesystem", "shell"]
+        },
+        {
+            name: "spec-reviewer",
+            objective: "Determine whether the implementation satisfies the requested behavior and acceptance criteria.",
+            permissions: { filesystem: "read", shell: "read-only", network: false },
+            context: contextNames,
+            skills: ["code-review"]
+        },
+        {
+            name: "standards-reviewer",
+            objective: "Determine whether the implementation follows repository engineering standards and architecture.",
+            permissions: { filesystem: "read", shell: "read-only", network: false },
+            context: contextNames,
+            skills: ["code-review"]
+        }
+    ];
+    const hook = {
+        name: "before-complete",
+        event: "before_complete",
+        run: commands
+    };
+    const evaluation = {
+        name: "feature-verification",
+        run: commands,
+        success: { exit_code: 0 }
+    };
+    const workflow = {
+        name: "feature",
+        description: "Take one feature request through clarification, specification, slicing, implementation, verification, independent review, and completion.",
+        steps: [
+            { id: "clarify", uses: "skill:clarify" },
+            { id: "spec", uses: "skill:spec", needs: ["clarify"] },
+            { id: "slice", uses: "skill:slice-work", needs: ["spec"] },
+            { id: "implement", uses: "agent:worker", needs: ["slice"] },
+            { id: "verify", uses: "eval:feature-verification", needs: ["implement"] },
+            { id: "review-spec", uses: "agent:spec-reviewer", needs: ["verify"] },
+            { id: "review-standards", uses: "agent:standards-reviewer", needs: ["verify"] },
+            { id: "complete", uses: "hook:before-complete", needs: ["review-spec", "review-standards"] }
+        ]
+    };
+    return { skills, agents, hook, evaluation, workflow, skillDocuments: { ...SKILL_DOCUMENTS } };
+}
+function workflowLevels(workflow) {
+    const pending = new Map(workflow.steps.map((step) => [step.id, step]));
+    const completed = new Set();
+    const levels = [];
+    while (pending.size > 0) {
+        const ready = [...pending.values()].filter((step) => (step.needs ?? []).every((need) => completed.has(need)));
+        if (ready.length === 0) {
+            throw new FeatureWorkflowError(`workflow '${workflow.name}' has a dependency cycle`);
+        }
+        levels.push(ready);
+        for (const step of ready) {
+            pending.delete(step.id);
+            completed.add(step.id);
+        }
+    }
+    return levels;
+}
+function findPrimitive(definition, uses) {
+    const [kind, name] = uses.split(":", 2);
+    const collections = {
+        skill: definition.skills,
+        agent: definition.agents,
+        hook: definition.hooks,
+        eval: definition.evals,
+        workflow: definition.workflows,
+        context: definition.context,
+        state: definition.state
+    };
+    const value = collections[kind].find((candidate) => candidate.name === name);
+    if (!value)
+        throw new FeatureWorkflowError(`workflow reference '${uses}' was not found`);
+    return { kind, value };
+}
+async function stageInstructions(step, definition, root, loadedSkills) {
+    const { kind, value } = findPrimitive(definition, step.uses);
+    if (kind === "skill") {
+        const invocation = await invokeSkill(value.name, root);
+        const newlyLoaded = invocation.skills.filter((skill) => !loadedSkills.has(skill.name));
+        for (const skill of invocation.skills)
+            loadedSkills.add(skill.name);
+        return newlyLoaded.map((skill) => `### Skill: ${skill.name}\n\n${skill.instructions}`).join("\n\n") || `Apply the already loaded '${value.name}' skill.`;
+    }
+    if (kind === "agent") {
+        const agent = value;
+        const skillSections = [];
+        for (const skillName of agent.skills ?? []) {
+            const invocation = await invokeSkill(skillName, root);
+            for (const skill of invocation.skills) {
+                if (loadedSkills.has(skill.name))
+                    continue;
+                loadedSkills.add(skill.name);
+                skillSections.push(`### Skill: ${skill.name}\n\n${skill.instructions}`);
+            }
+        }
+        const contextPaths = (agent.context ?? []).map((name) => {
+            const item = definition.context.find((candidate) => candidate.name === name);
+            return item ? `${name} (${item.path})` : name;
+        });
+        const reviewBoundary = agent.name === "spec-reviewer"
+            ? "Review axis: SPEC ONLY. Inspect request, specification, acceptance criteria, diff, and tests. Ignore style and architecture. Return JSON with verdict, summary, and evidence-backed behavior findings."
+            : agent.name === "standards-reviewer"
+                ? "Review axis: STANDARDS ONLY. Inspect project context, diff, architecture, maintainability, and tests. Do not judge whether requested behavior is complete. Return JSON with verdict, summary, and evidence-backed engineering findings."
+                : undefined;
+        return [
+            `Objective: ${agent.objective}`,
+            ...(reviewBoundary ? [reviewBoundary] : []),
+            `Permissions: filesystem=${agent.permissions.filesystem}, shell=${agent.permissions.shell}, network=${agent.permissions.network ?? false}`,
+            `Context: ${contextPaths.join(", ") || "none"}`,
+            ...skillSections
+        ].join("\n\n");
+    }
+    if (kind === "eval") {
+        const evaluation = value;
+        return `Run every command and record literal evidence:\n${evaluation.run.map((command) => `- ${command}`).join("\n")}\nPass condition: exit_code=${evaluation.success.exit_code}.`;
+    }
+    if (kind === "hook") {
+        const hook = value;
+        return `Lifecycle gate: ${hook.event}. Run:\n${hook.run.map((command) => `- ${command}`).join("\n")}\nThis gate must pass before completion.`;
+    }
+    return `Load and apply ${step.uses}.`;
+}
+/** Compile the official feature DAG into one executable agent invocation packet. */
+export async function createFeatureInvocation(request, projectDirectory = ".") {
+    const normalized = request.trim();
+    if (!normalized)
+        throw new FeatureWorkflowError("the feature request must be a non-empty string");
+    const root = resolve(projectDirectory);
+    const configPath = join(root, ".yaaw", "yaaw.yaml");
+    const validation = await loadAndValidateProjectDefinition(configPath);
+    if (!validation.ok) {
+        const details = validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ");
+        throw new FeatureWorkflowError(`${configPath} is invalid: ${details}`);
+    }
+    const workflow = validation.value.workflows.find(({ name }) => name === "feature");
+    if (!workflow)
+        throw new FeatureWorkflowError("the project does not define the official 'feature' workflow");
+    const levels = workflowLevels(workflow);
+    const loadedSkills = new Set();
+    const stages = [];
+    const promptSections = [
+        "# YAAW feature workflow",
+        "",
+        `Request: ${normalized}`,
+        "",
+        "Execute stages in dependency order. Steps in the same parallel group are independent. Do not claim completion until verification, both review axes, and the completion gate pass. Repair failures and repeat the affected gates."
+    ];
+    for (const [levelIndex, level] of levels.entries()) {
+        const heading = level.length > 1
+            ? `## Parallel group ${levelIndex + 1}: ${level.map(({ id }) => id).join(" + ")}`
+            : `## Stage ${levelIndex + 1}: ${level[0].id}`;
+        promptSections.push("", heading);
+        for (const step of level) {
+            const instructions = await stageInstructions(step, validation.value, root, loadedSkills);
+            const stage = {
+                id: step.id,
+                uses: step.uses,
+                needs: [...(step.needs ?? [])],
+                instructions
+            };
+            stages.push(stage);
+            promptSections.push("", `### ${step.id} (${step.uses})`, "", instructions);
+        }
+    }
+    promptSections.push("", "## Completion record", "", "Submit the two review reports independently with `yaaw review spec --data <file>` and `yaaw review standards --data <file>`. Return the resolved decisions, specification, slices, changed files, exact verification commands and results, both review verdicts, repairs, and final gate status.");
+    return {
+        request: normalized,
+        workflow: workflow.name,
+        order: stages.map(({ id }) => id),
+        parallelGroups: levels.filter((level) => level.length > 1).map((level) => level.map(({ id }) => id)),
+        stages,
+        prompt: promptSections.join("\n")
+    };
+}
+//# sourceMappingURL=feature.js.map

package/dist/feature.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { AdapterError, syncAdapterSkills } from "./adapters.js";
+export { ArchitectError, architectWorkflow, diagnoseArchitecture } from "./architect.js";
+export { createFeatureInvocation, createOfficialFeaturePrimitives, FeatureWorkflowError } from "./feature.js";
+export { discoverRepository, InitConflictError, initializeRepository, relativeInitPaths } from "./init.js";
+export { loadAndValidateProjectDefinition, parseAndValidateProjectDefinition, parseProjectDefinition, validateProjectDefinition } from "./parser.js";
+export { discoverSkills, displaySkillPath, invokeSkill, SkillSystemError } from "./skills.js";
+export { checkpointFeatureWorkflow, loadWorkflowState, PersistenceError, resumeFeatureWorkflow, startFeatureWorkflow, submitIndependentReview } from "./persistence.js";
+export { assertIndependentReviewGate, createReviewRecord, ReviewError } from "./review.js";
+export { finishWorkflowRun, ObservabilityError, readWorkflowRun, recordWorkflowRunEvent, startWorkflowRun } from "./observability.js";
+export { applyInstallation, detectLegacyProviders, doctorRepository, installRepository, MANAGED_BLOCK_END, MANAGED_BLOCK_START, MANAGED_INSTRUCTION_BLOCK, planInstallation, providerNames, readInstallManifest } from "./installer.js";
+export { getProvider, listProviders, providerRegistry } from "./providers.js";
+export type { AdapterDifference, AdapterManifest, AdapterName, AdapterSkillRecord, AdapterSyncOptions, AdapterSyncResult } from "./adapters.js";
+export type { ArchitectAnswers, ArchitectDiagnosis, ArchitectOptions, ArchitectResult } from "./architect.js";
+export type { FeatureInvocation, FeatureStage, OfficialFeaturePrimitives } from "./feature.js";
+export type { CommandKind, InitOptions, InitResult, RepositoryDiscovery } from "./init.js";
+export type { AgentDefinition, ContextDefinition, EvalDefinition, HookDefinition, ProjectDefinition, SkillDefinition, StateDefinition, ValidationIssue, ValidationResult, WorkflowDefinition, WorkflowStepDefinition } from "./types.js";
+export type { LoadedSkill, SkillInvocation, SkillSummary } from "./skills.js";
+export type { CheckpointUpdate, DecisionRecord, HandoffRecord, PersistedFeatureInvocation, PersistedSlice, VerificationRecord, WorkflowState, WorkflowStatus } from "./persistence.js";
+export type { IndependentReviews, ReviewAxis, ReviewFinding, ReviewRecord, ReviewSubmission, ReviewVerdict } from "./review.js";
+export type { RecordWorkflowRunOptions, StartWorkflowRunOptions, WorkflowResult, WorkflowRun, WorkflowRunEvent, WorkflowRunEventType } from "./observability.js";
+export type { DoctorCheck, DoctorResult, InstallationPlan, InstallManifest, InstallOperation, InstallOptions, InstallResult, ManagedFileRecord, PlanKind, PlanStatus } from "./installer.js";
+export type { ProviderDefinition, ProviderId } from "./providers.js";

package/dist/index.js

@@ -0,0 +1,12 @@
+export { AdapterError, syncAdapterSkills } from "./adapters.js";
+export { ArchitectError, architectWorkflow, diagnoseArchitecture } from "./architect.js";
+export { createFeatureInvocation, createOfficialFeaturePrimitives, FeatureWorkflowError } from "./feature.js";
+export { discoverRepository, InitConflictError, initializeRepository, relativeInitPaths } from "./init.js";
+export { loadAndValidateProjectDefinition, parseAndValidateProjectDefinition, parseProjectDefinition, validateProjectDefinition } from "./parser.js";
+export { discoverSkills, displaySkillPath, invokeSkill, SkillSystemError } from "./skills.js";
+export { checkpointFeatureWorkflow, loadWorkflowState, PersistenceError, resumeFeatureWorkflow, startFeatureWorkflow, submitIndependentReview } from "./persistence.js";
+export { assertIndependentReviewGate, createReviewRecord, ReviewError } from "./review.js";
+export { finishWorkflowRun, ObservabilityError, readWorkflowRun, recordWorkflowRunEvent, startWorkflowRun } from "./observability.js";
+export { applyInstallation, detectLegacyProviders, doctorRepository, installRepository, MANAGED_BLOCK_END, MANAGED_BLOCK_START, MANAGED_INSTRUCTION_BLOCK, planInstallation, providerNames, readInstallManifest } from "./installer.js";
+export { getProvider, listProviders, providerRegistry } from "./providers.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":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,26 @@
+export type CommandKind = "test" | "lint" | "typecheck" | "build";
+export interface RepositoryDiscovery {
+    root: string;
+    projectName: string;
+    languages: string[];
+    packageManager?: string;
+    commands: Partial<Record<CommandKind, string>>;
+    git: boolean;
+    aiInstructions: string[];
+}
+export interface InitOptions {
+    force?: boolean;
+}
+export interface InitResult {
+    discovery: RepositoryDiscovery;
+    configPath: string;
+    discoveryPath: string;
+    statePath: string;
+    skillPaths: string[];
+}
+export declare class InitConflictError extends Error {
+    constructor(path: string);
+}
+export declare function discoverRepository(directory?: string): Promise<RepositoryDiscovery>;
+export declare function initializeRepository(directory?: string, options?: InitOptions): Promise<InitResult>;
+export declare function relativeInitPaths(result: InitResult): string[];