@jakkrichm/create-nexus-devflow 2.0.25 → 2.1.0

package/dist/lib/discoveries.d.ts

@@ -0,0 +1,19 @@
+interface DiscoveryItem {
+    id: string;
+    title: string;
+    date: string | null;
+    decision: "Proceed" | "Defer" | "Reject" | "Unknown";
+    approvalStatus: string | null;
+    status: string | null;
+    file: string;
+}
+interface DiscoverySummary {
+    total: number;
+    activeId: string | null;
+    active: DiscoveryItem | null;
+    recent: DiscoveryItem[];
+}
+declare function readDiscoveries(projectRoot: string, activeId?: string | null): Promise<DiscoverySummary>;
+declare function parseDiscovery(markdown: string, file: string, fallbackId: string): DiscoveryItem;
+export { parseDiscovery, readDiscoveries };
+export type { DiscoveryItem, DiscoverySummary };

package/dist/lib/discoveries.js

@@ -0,0 +1,81 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+async function readDiscoveries(projectRoot, activeId = null) {
+    const root = path.join(projectRoot, "devflow", "discoveries");
+    let entries;
+    try {
+        entries = await fs.readdir(root, { withFileTypes: true });
+    }
+    catch (error) {
+        if (getErrorCode(error) === "ENOENT")
+            return emptySummary(activeId);
+        throw error;
+    }
+    const items = await Promise.all(entries
+        .filter((entry) => entry.isDirectory() && !entry.isSymbolicLink())
+        .map(async (entry) => {
+        const file = path.join(entry.name, "00-explore.md");
+        try {
+            const markdown = await fs.readFile(path.join(root, file), "utf8");
+            return parseDiscovery(markdown, file, entry.name);
+        }
+        catch (error) {
+            if (getErrorCode(error) === "ENOENT")
+                return null;
+            throw error;
+        }
+    }));
+    const valid = items.filter((item) => item !== null)
+        .sort((left, right) => right.id.localeCompare(left.id));
+    return {
+        total: valid.length,
+        activeId,
+        active: valid.find((item) => item.id === activeId) || null,
+        recent: valid.slice(0, 6)
+    };
+}
+function parseDiscovery(markdown, file, fallbackId) {
+    const id = field(markdown, "Discovery ID") || fallbackId.match(/DISC-\d{8}-\d{3}/)?.[0] || fallbackId;
+    const heading = markdown.match(/^#\s+(.+)$/m)?.[1]?.trim() || fallbackId;
+    const title = heading
+        .replace(/^.*?\]\s*/, "")
+        .replace(/^Discovery Document:\s*/i, "")
+        .trim();
+    const finalDecision = markdown.match(/Final Decision:\s*`?(Proceed|Defer|Reject)`?/i)?.[1];
+    const status = field(markdown, "Status");
+    const statusDecision = status?.match(/\b(Proceed|Defer|Reject)\b/i)?.[1];
+    const normalizedDecision = finalDecision || statusDecision;
+    return {
+        id,
+        title,
+        date: field(markdown, "Date"),
+        decision: normalizeDecision(normalizedDecision),
+        approvalStatus: field(markdown, "Approval Status"),
+        status,
+        file: file.replaceAll("\\", "/")
+    };
+}
+function field(markdown, label) {
+    const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return markdown.match(new RegExp(`\\*\\*${escaped}\\*\\*:\\s*\\x60?([^\\r\\n\\x60]+)`, "i"))?.[1]?.trim() || null;
+}
+function normalizeDecision(value) {
+    const normalized = value?.toLowerCase();
+    if (normalized === "proceed")
+        return "Proceed";
+    if (normalized === "defer")
+        return "Defer";
+    if (normalized === "reject")
+        return "Reject";
+    return "Unknown";
+}
+function emptySummary(activeId) {
+    return { total: 0, activeId, active: null, recent: [] };
+}
+function getErrorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error && typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { parseDiscovery, readDiscoveries };
+//# sourceMappingURL=discoveries.js.map

package/dist/lib/discoveries.js.map

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

package/dist/lib/doctor.d.ts

@@ -0,0 +1,26 @@
+export interface DoctorCheck {
+    id: string;
+    name: string;
+    status: "pass" | "warn" | "fail";
+    message: string;
+    fixable: boolean;
+    fixed?: boolean;
+}
+export interface DoctorReport {
+    projectRoot: string;
+    isDevFlowProject: boolean;
+    checks: DoctorCheck[];
+    totalChecks: number;
+    passCount: number;
+    warnCount: number;
+    failCount: number;
+    fixedCount: number;
+}
+export interface DoctorOptions {
+    fix?: boolean;
+    color?: boolean;
+}
+export declare function runDoctor(projectRoot: string, options?: DoctorOptions): Promise<DoctorReport>;
+export declare function formatDoctorHuman(report: DoctorReport, options?: {
+    color?: boolean;
+}): string;

package/dist/lib/doctor.js

@@ -0,0 +1,474 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { isDevFlowProjectRoot } from "./project-root.js";
+import { createStyle } from "./ui.js";
+const DEFAULT_FINDINGS_STUB = `# Findings Ledger
+
+> **Generated Ledger File.** Tracks quality findings, security vulnerabilities, regression risks, and architectural debt raised during review and QA passes.
+>
+> **Finding Format**:
+> \`### <ID> [<SEVERITY>] <STATUS> - <Title>\`
+> - **Severities**: \`P0\` (Critical Blocker), \`P1\` (High Blocker), \`P2\` (Medium), \`P3\` (Low / Polish)
+> - **Statuses**: \`unverified\`, \`open\`, \`fixed\`, \`closed\`, \`accepted\`, \`invalid\`
+> - **Release Gate Rule**: Any \`P0\` or \`P1\` finding in \`open\` or \`fixed\` status unconditionally blocks \`/complete\` and \`70-deliver\`.
+
+---
+
+_No active findings recorded. QA and audit passes append findings here as they are discovered._
+`;
+const DEFAULT_CURRENT_STAGE_STUB = `# Current DevFlow Run Status
+
+- **Active Discovery ID**: \`None\`
+- **Active Running ID**: \`None\`
+- **Current Stage**: \`Idle (Ready for /feature or /fix)\`
+- **Living Spec**: \`None\`
+- **Last Completed Run**: \`None\`
+- **Last Updated**: ${new Date().toISOString().split("T")[0]}
+`;
+const DEFAULT_CURRENT_FEATURE_STUB = `# Current Feature
+
+_Nothing in progress. Run /feature, /fix, or /rollback to start._
+`;
+const DEFAULT_IDEAS_STUB = `# 💡 DevFlow Idea Inbox & Backlog
+
+บันทึกไอเดียที่รอดำเนินการ พร้อมบทวิเคราะห์ความเป็นไปได้เบื้องต้นจาก AI (บันทึกด้วยคำสั่ง \`/idea "<text>"\`)
+
+---
+
+## 📌 Pending Ideas
+
+---
+
+## 📦 Archived / Shipped Ideas
+`;
+const DEFAULT_HISTORY_STUB = `# Nexus-DevFlow Master Release History Ledger
+
+This master ledger tracks all released delivery runs, milestones, and rollbacks in chronological order. Each entry is recorded during \`/complete\` or \`70-deliver\` and links to its exact Git commit hash, release status, category, and archived delivery artifacts.
+
+---
+
+## 📜 Master Release Log
+
+| Completed Date | Run ID | Category | Title | Git Commit | Status | Archive Link |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+
+---
+
+## 🗄️ History Categories (The Core 3 Model)
+
+- **\`features/\`**: New user-facing features, enhancements, architecture migrations, refactoring, and tooling/infra.
+- **\`fixes/\`**: Bug fixes, hotfixes, regressions, security patches, and performance optimizations.
+- **\`rollbacks/\`**: Safe feature reversal and rollback execution records.
+`;
+const DEFAULT_PROJECT_PLAN_STUB = `# 🗺️ Project Plan (User-Owned Architectural Vision)
+
+> **Document Type**: Project Plan (User-Owned)  
+> **Purpose**: Single source of truth for high-level product vision, architecture, constraints, and non-goals. Distilled into \`devflow/context/project-overview.md\` by \`/overview\`.
+
+---
+
+## 1. Product Vision & Problem Statement
+- **What this is**: A description of the project and the core problem it solves.
+- **Target Audience**: Who will use this system and why.
+- **Core Value Proposition**: Key differentiator and value delivered.
+
+## 2. Architecture & Tech Stack
+- **Runtime / Framework**: Primary language, framework, and runtime (e.g. Node.js, Next.js, FastAPI, Go).
+- **Storage / Database**: Data persistence layers, caching, and state storage.
+- **Key Modules / Services**: High-level module breakdown and directory responsibilities.
+- **Integration Points**: External APIs, MCP servers, or third-party services.
+
+## 3. Constraints & Non-Goals
+- **Non-Goals**: What this project explicitly will NOT do in the current scope.
+- **Technical Constraints**: Performance targets, security standards, offline requirements, or backward compatibility rules.
+- **Delivery Rules**: Dual-Track workflow discipline (Fast-Track for standard features, Deep-Track for epics).
+
+## 4. Key Milestones & Roadmap
+- **Milestone 1**: Core Foundation & MVP
+- **Milestone 2**: Feature Expansion & Integrations
+- **Milestone 3**: Enterprise Hardening & Release Polish
+`;
+const DEFAULT_BUILD_PLAN_STUB = `# 📋 Build Plan (User-Owned Feature Queue)
+
+> **Document Type**: Build Plan (User-Owned)  
+> **Purpose**: Master sequential feature build queue with dependencies and sizing. Inspected by \`/brief\` and consumed by \`/feature\`.
+
+---
+
+## 🚀 Phase 1: Core Foundation & MVP
+
+- [ ] **1. Project Baseline & Context Setup** \`[Size: S]\`
+  - *Dependencies*: None
+  - *Scope*: Configure project scaffolding, coding standards, and initial workspace verification.
+- [ ] **2. Core Data Models & Store** \`[Size: M]\`
+  - *Dependencies*: Feature 1
+  - *Scope*: Implement foundational data schemas, types, and persistence layer.
+- [ ] **3. Primary User Interface & Navigation** \`[Size: M]\`
+  - *Dependencies*: Feature 2
+  - *Scope*: Build core views, interactive components, and responsive layout.
+
+---
+
+## ⚡ Phase 2: Feature Expansion & Integrations
+
+- [ ] **4. Automated Quality Gates & CI Pipeline** \`[Size: M]\`
+  - *Dependencies*: Phase 1
+  - *Scope*: Wire up \`nexus-devflow check-gate\`, GitHub Actions workflows, and pre-commit hooks.
+- [ ] **5. External Services & Tooling** \`[Size: L]\`
+  - *Dependencies*: Feature 4
+  - *Scope*: Integrate third-party APIs, MCP servers, or background worker jobs.
+
+---
+
+## 📦 Phase 3: Hardening & Production Release
+
+- [ ] **6. Security & Performance Audit** \`[Size: M]\`
+  - *Dependencies*: Phase 2
+  - *Scope*: Run \`/audit\`, resolve P0/P1 blockers, and optimize asset bundle sizes.
+- [ ] **7. Production Deployment & Cloud Smoke Tests** \`[Size: S]\`
+  - *Dependencies*: Feature 6
+  - *Scope*: Configure Render / Vercel deployment and run end-to-end smoke tests.
+`;
+async function fileExists(filePath) {
+    try {
+        const stats = await fs.lstat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function dirExists(dirPath) {
+    try {
+        const stats = await fs.lstat(dirPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function runDoctor(projectRoot, options = {}) {
+    const isDevFlow = await isDevFlowProjectRoot(projectRoot);
+    const checks = [];
+    // Check 1: Project Root
+    if (isDevFlow) {
+        checks.push({
+            id: "project_root",
+            name: "DevFlow Project Root",
+            status: "pass",
+            message: "Directory contains DevFlow workspace markers (AGENTS.md & devflow/).",
+            fixable: false
+        });
+    }
+    else {
+        checks.push({
+            id: "project_root",
+            name: "DevFlow Project Root",
+            status: "fail",
+            message: "Not a recognized DevFlow project directory.",
+            fixable: false
+        });
+    }
+    // Check 2: Internal State Manifest
+    const manifestPath = path.join(projectRoot, ".nexus", "nexus-devflow.json");
+    const hasManifest = await fileExists(manifestPath);
+    if (hasManifest) {
+        try {
+            const parsed = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+            checks.push({
+                id: "manifest_state",
+                name: "Internal State Manifest (.nexus/)",
+                status: "pass",
+                message: `Manifest valid (version: ${parsed.version || "unknown"}, mode: ${parsed.mode || "standard"}).`,
+                fixable: false
+            });
+        }
+        catch {
+            checks.push({
+                id: "manifest_state",
+                name: "Internal State Manifest (.nexus/)",
+                status: "warn",
+                message: "Manifest file is malformed JSON.",
+                fixable: true
+            });
+        }
+    }
+    else {
+        checks.push({
+            id: "manifest_state",
+            name: "Internal State Manifest (.nexus/)",
+            status: "warn",
+            message: "Manifest (.nexus/nexus-devflow.json) not found.",
+            fixable: true
+        });
+    }
+    // Check 3: Adapters
+    const hasAgentsDir = await dirExists(path.join(projectRoot, ".agents"));
+    const hasClaudeDir = await dirExists(path.join(projectRoot, ".claude"));
+    if (hasAgentsDir || hasClaudeDir) {
+        const adapters = [];
+        if (hasAgentsDir)
+            adapters.push("Codex/Copilot/Antigravity (.agents)");
+        if (hasClaudeDir)
+            adapters.push("Claude Code (.claude)");
+        checks.push({
+            id: "ai_adapters",
+            name: "AI Tool Adapters",
+            status: "pass",
+            message: `Active adapters detected: ${adapters.join(", ")}.`,
+            fixable: false
+        });
+    }
+    else {
+        checks.push({
+            id: "ai_adapters",
+            name: "AI Tool Adapters",
+            status: "warn",
+            message: "No AI adapter folders (.agents or .claude) detected.",
+            fixable: false
+        });
+    }
+    // Check 4: Core Context Files
+    const contextFiles = [
+        { name: "current-stage.md", path: path.join("devflow", "context", "current-stage.md"), stub: DEFAULT_CURRENT_STAGE_STUB },
+        { name: "current-feature.md", path: path.join("devflow", "context", "current-feature.md"), stub: DEFAULT_CURRENT_FEATURE_STUB },
+        { name: "findings.md", path: path.join("devflow", "context", "findings.md"), stub: DEFAULT_FINDINGS_STUB },
+        { name: "project-overview.md", path: path.join("devflow", "context", "project-overview.md"), stub: "# Project Overview\n\n_Source of truth for project architecture and domain rules._\n" },
+        { name: "coding-standards.md", path: path.join("devflow", "context", "coding-standards.md"), stub: "# Coding Standards\n\n_Engineering conventions and quality standards._\n" },
+        { name: "ai-interaction.md", path: path.join("devflow", "context", "ai-interaction.md"), stub: "# AI Interaction Guidelines\n\n_Rules and guidelines for interacting with AI agents._\n" }
+    ];
+    for (const cf of contextFiles) {
+        const absPath = path.join(projectRoot, cf.path);
+        const exists = await fileExists(absPath);
+        if (exists) {
+            checks.push({
+                id: `context_${cf.name}`,
+                name: `Context File (${cf.name})`,
+                status: "pass",
+                message: `Found at ${cf.path}.`,
+                fixable: false
+            });
+        }
+        else {
+            let fixed = false;
+            if (options.fix) {
+                await fs.mkdir(path.dirname(absPath), { recursive: true });
+                await fs.writeFile(absPath, cf.stub, "utf8");
+                fixed = true;
+            }
+            checks.push({
+                id: `context_${cf.name}`,
+                name: `Context File (${cf.name})`,
+                status: fixed ? "pass" : "warn",
+                message: fixed ? `Restored stub at ${cf.path}.` : `Missing at ${cf.path}.`,
+                fixable: true,
+                fixed
+            });
+        }
+    }
+    // Check 5: Planning Documents (project-plan.md & build-plan.md)
+    const projectPlanPath = path.join(projectRoot, "devflow", "project-plan.md");
+    const buildPlanPath = path.join(projectRoot, "devflow", "build-plan.md");
+    const hasProjectPlan = await fileExists(projectPlanPath);
+    const hasBuildPlan = await fileExists(buildPlanPath);
+    if (hasProjectPlan && hasBuildPlan) {
+        checks.push({
+            id: "planning_documents",
+            name: "Planning Documents (project-plan.md & build-plan.md)",
+            status: "pass",
+            message: "Both project-plan.md and build-plan.md are present.",
+            fixable: false
+        });
+    }
+    else if (hasProjectPlan || hasBuildPlan) {
+        let fixed = false;
+        if (options.fix) {
+            if (!hasProjectPlan)
+                await fs.writeFile(projectPlanPath, DEFAULT_PROJECT_PLAN_STUB, "utf8");
+            if (!hasBuildPlan)
+                await fs.writeFile(buildPlanPath, DEFAULT_BUILD_PLAN_STUB, "utf8");
+            fixed = true;
+        }
+        checks.push({
+            id: "planning_documents",
+            name: "Planning Documents (project-plan.md & build-plan.md)",
+            status: fixed ? "pass" : "warn",
+            message: fixed
+                ? "Restored missing planning document."
+                : `Partially present (${hasProjectPlan ? "project-plan.md present" : "build-plan.md present"}).`,
+            fixable: true,
+            fixed
+        });
+    }
+    else {
+        let fixed = false;
+        if (options.fix) {
+            await fs.writeFile(projectPlanPath, DEFAULT_PROJECT_PLAN_STUB, "utf8");
+            await fs.writeFile(buildPlanPath, DEFAULT_BUILD_PLAN_STUB, "utf8");
+            fixed = true;
+        }
+        checks.push({
+            id: "planning_documents",
+            name: "Planning Documents (project-plan.md & build-plan.md)",
+            status: fixed ? "pass" : "warn",
+            message: fixed
+                ? "Initialized project-plan.md and build-plan.md."
+                : "User-owned planning documents not configured (optional, recommended for long-term roadmap).",
+            fixable: true,
+            fixed
+        });
+    }
+    // Check 6: Ideas File
+    const ideasPath = path.join(projectRoot, "devflow", "ideas.md");
+    const hasIdeas = await fileExists(ideasPath);
+    if (hasIdeas) {
+        checks.push({
+            id: "ideas_inbox",
+            name: "Idea Inbox (devflow/ideas.md)",
+            status: "pass",
+            message: "Found at devflow/ideas.md.",
+            fixable: false
+        });
+    }
+    else {
+        let fixed = false;
+        if (options.fix) {
+            await fs.mkdir(path.dirname(ideasPath), { recursive: true });
+            await fs.writeFile(ideasPath, DEFAULT_IDEAS_STUB, "utf8");
+            fixed = true;
+        }
+        checks.push({
+            id: "ideas_inbox",
+            name: "Idea Inbox (devflow/ideas.md)",
+            status: fixed ? "pass" : "warn",
+            message: fixed ? "Restored stub at devflow/ideas.md." : "Missing devflow/ideas.md.",
+            fixable: true,
+            fixed
+        });
+    }
+    // Check 7: History Directory Structure
+    const historyDir = path.join(projectRoot, "devflow", "history");
+    const historyLedger = path.join(historyDir, "HISTORY.md");
+    const featuresDir = path.join(historyDir, "features");
+    const fixesDir = path.join(historyDir, "fixes");
+    const rollbacksDir = path.join(historyDir, "rollbacks");
+    const hasHistory = await dirExists(historyDir);
+    const hasLedger = await fileExists(historyLedger);
+    const hasFeatures = await dirExists(featuresDir);
+    const hasFixes = await dirExists(fixesDir);
+    const hasRollbacks = await dirExists(rollbacksDir);
+    if (hasHistory && hasLedger && hasFeatures && hasFixes && hasRollbacks) {
+        checks.push({
+            id: "history_structure",
+            name: "History Ledger & Archives (devflow/history/)",
+            status: "pass",
+            message: "Master ledger and categorized subdirectories (features, fixes, rollbacks) intact.",
+            fixable: false
+        });
+    }
+    else {
+        let fixed = false;
+        if (options.fix) {
+            await fs.mkdir(featuresDir, { recursive: true });
+            await fs.mkdir(fixesDir, { recursive: true });
+            await fs.mkdir(rollbacksDir, { recursive: true });
+            if (!hasLedger) {
+                await fs.writeFile(historyLedger, DEFAULT_HISTORY_STUB, "utf8");
+            }
+            fixed = true;
+        }
+        checks.push({
+            id: "history_structure",
+            name: "History Ledger & Archives (devflow/history/)",
+            status: fixed ? "pass" : "warn",
+            message: fixed ? "Repaired devflow/history/ directories and HISTORY.md." : "devflow/history/ structure incomplete.",
+            fixable: true,
+            fixed
+        });
+    }
+    // Check 8: Reference & Discoveries Directories
+    const refDir = path.join(projectRoot, "devflow", "reference");
+    const discDir = path.join(projectRoot, "devflow", "discoveries");
+    const hasRef = await dirExists(refDir);
+    const hasDisc = await dirExists(discDir);
+    if (hasRef && hasDisc) {
+        checks.push({
+            id: "reference_discoveries",
+            name: "Support Folders (reference/ & discoveries/)",
+            status: "pass",
+            message: "Folders present for document conversion and discovery storage.",
+            fixable: false
+        });
+    }
+    else {
+        let fixed = false;
+        if (options.fix) {
+            await fs.mkdir(refDir, { recursive: true });
+            await fs.mkdir(discDir, { recursive: true });
+            fixed = true;
+        }
+        checks.push({
+            id: "reference_discoveries",
+            name: "Support Folders (reference/ & discoveries/)",
+            status: fixed ? "pass" : "warn",
+            message: fixed ? "Created devflow/reference/ and devflow/discoveries/." : "Missing reference/ or discoveries/ folder.",
+            fixable: true,
+            fixed
+        });
+    }
+    let passCount = 0;
+    let warnCount = 0;
+    let failCount = 0;
+    let fixedCount = 0;
+    for (const c of checks) {
+        if (c.fixed)
+            fixedCount++;
+        if (c.status === "pass")
+            passCount++;
+        else if (c.status === "warn")
+            warnCount++;
+        else if (c.status === "fail")
+            failCount++;
+    }
+    return {
+        projectRoot,
+        isDevFlowProject: isDevFlow,
+        checks,
+        totalChecks: checks.length,
+        passCount,
+        warnCount,
+        failCount,
+        fixedCount
+    };
+}
+export function formatDoctorHuman(report, options = {}) {
+    const style = createStyle(options.color);
+    const lines = [];
+    lines.push(style.bold(`Nexus-DevFlow Doctor Health Report (${report.passCount} passed, ${report.warnCount} warnings, ${report.failCount} failed)`));
+    if (report.fixedCount > 0) {
+        lines.push(style.green(`  ⚡ Auto-healed ${report.fixedCount} items via --fix`));
+    }
+    lines.push("");
+    for (const check of report.checks) {
+        let icon = style.green("✔");
+        if (check.status === "warn")
+            icon = style.yellow("⚠");
+        if (check.status === "fail")
+            icon = style.red("✖");
+        let statusText = style.green("PASS");
+        if (check.status === "warn")
+            statusText = style.yellow("WARN");
+        if (check.status === "fail")
+            statusText = style.red("FAIL");
+        if (check.fixed)
+            statusText = style.cyan("FIXED");
+        lines.push(`  ${icon} ${style.bold(check.name)} [${statusText}]`);
+        lines.push(`     ${style.dim(check.message)}`);
+    }
+    lines.push("");
+    if (report.warnCount > 0 && report.fixedCount === 0) {
+        lines.push(style.yellow("Tip: Run `nexus-devflow doctor --fix` to automatically repair missing context and folders."));
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=doctor.js.map

package/dist/lib/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../lib/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA2BtC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;CAa7B,CAAC;AAEF,MAAM,0BAA0B,GAAG;;;;;;;sBAOb,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,MAAM,4BAA4B,GAAG;;;CAGpC,CAAC;AAEF,MAAM,kBAAkB,GAAG;;;;;;;;;;;CAW1B,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;CAkB5B,CAAC;AAEF,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BjC,CAAC;AAEF,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAC;AAEF,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,UAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,wBAAwB;IACxB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,cAAc;YAClB,IAAI,EAAE,sBAAsB;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,sEAAsE;YAC/E,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,cAAc;YAClB,IAAI,EAAE,sBAAsB;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,6CAA6C;YACtD,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,gBAAgB;gBACpB,IAAI,EAAE,mCAAmC;gBACzC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,4BAA4B,MAAM,CAAC,OAAO,IAAI,SAAS,WAAW,MAAM,CAAC,IAAI,IAAI,UAAU,IAAI;gBACxG,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,gBAAgB;gBACpB,IAAI,EAAE,mCAAmC;gBACzC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,kCAAkC;gBAC3C,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,mCAAmC;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,iDAAiD;YAC1D,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACxE,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,YAAY;YAAE,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACvE,IAAI,YAAY;YAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,6BAA6B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC5D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,sDAAsD;YAC/D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG;QACnB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE;QACzH,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,oBAAoB,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE;QAC/H,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;QAC1G,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,sFAAsF,EAAE;QAC3L,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,0EAA0E,EAAE;QAC/K,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,mBAAmB,CAAC,EAAE,IAAI,EAAE,yFAAyF,EAAE;KAC3L,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE;gBACxB,IAAI,EAAE,iBAAiB,EAAE,CAAC,IAAI,GAAG;gBACjC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,YAAY,EAAE,CAAC,IAAI,GAAG;gBAC/B,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC7C,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE;gBACxB,IAAI,EAAE,iBAAiB,EAAE,CAAC,IAAI,GAAG;gBACjC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC/B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,GAAG;gBAC1E,OAAO,EAAE,IAAI;gBACb,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;IAErD,IAAI,cAAc,IAAI,YAAY,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,sDAAsD;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,qDAAqD;YAC9D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,cAAc,IAAI,YAAY,EAAE,CAAC;QAC1C,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,cAAc;gBAAE,MAAM,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC5F,IAAI,CAAC,YAAY;gBAAE,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;YACtF,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,sDAAsD;YAC5D,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/B,OAAO,EAAE,KAAK;gBACZ,CAAC,CAAC,qCAAqC;gBACvC,CAAC,CAAC,sBAAsB,cAAc,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,uBAAuB,IAAI;YAClG,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC;YACvE,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;YACnE,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,sDAAsD;YAC5D,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/B,OAAO,EAAE,KAAK;gBACZ,CAAC,CAAC,gDAAgD;gBAClD,CAAC,CAAC,6FAA6F;YACjG,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,+BAA+B;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;YAC1D,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,+BAA+B;YACrC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,2BAA2B;YACnF,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAExD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAEnD,IAAI,UAAU,IAAI,SAAS,IAAI,WAAW,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,8CAA8C;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,mFAAmF;YAC5F,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAClE,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,8CAA8C;YACpD,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,uDAAuD,CAAC,CAAC,CAAC,wCAAwC;YACnH,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,uBAAuB;YAC3B,IAAI,EAAE,6CAA6C;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,gEAAgE;YACzE,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,uBAAuB;YAC3B,IAAI,EAAE,6CAA6C;YACnD,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,sDAAsD,CAAC,CAAC,CAAC,4CAA4C;YACtH,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,KAAK;YAAE,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS,EAAE,CAAC;aAChC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS,EAAE,CAAC;aACrC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,WAAW;QACX,gBAAgB,EAAE,SAAS;QAC3B,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,SAAS;QACT,SAAS;QACT,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,UAA+B,EAAE;IAEjC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,IAAI,CACR,uCAAuC,MAAM,CAAC,SAAS,YAAY,MAAM,CAAC,SAAS,cAAc,MAAM,CAAC,SAAS,UAAU,CAC5H,CACF,CAAC;IACF,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,UAAU,kBAAkB,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEnD,IAAI,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,KAAK;YAAE,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,GAAG,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,4FAA4F,CAAC,CAAC,CAAC;IACzH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/lib/drift-reconciler.d.ts

@@ -0,0 +1,38 @@
+export interface GitDriftReport {
+    hasDrift: boolean;
+    undocumentedFiles: string[];
+    phantomFiles: string[];
+    matchedFiles: string[];
+    gitModifiedFiles: string[];
+    specFiles: string[];
+    stageDrift: {
+        isDrifted: boolean;
+        activeBranch: string | null;
+        stageRunningId: string | null;
+    };
+}
+export interface ReconcileResult {
+    reconciled: boolean;
+    addedFiles: string[];
+    healedStage: boolean;
+    message: string;
+}
+/**
+ * Normalizes file path to forward slashes relative to workspace root.
+ */
+export declare function normalizeRelativePath(projectRoot: string, filePath: string): string;
+/**
+ * Parses the "Files to Modify/Create" section from a living spec markdown.
+ */
+export declare function parseSpecFilesList(specContent: string): string[];
+/**
+ * Detects git drift between modified repository files and spec declaration.
+ */
+export declare function detectGitDrift(projectRoot: string, explicitBranch?: string): Promise<GitDriftReport>;
+/**
+ * Automatically reconciles and synchronizes living spec and stage file.
+ */
+export declare function reconcileState(projectRoot: string, options?: {
+    autoAddUndocumented?: boolean;
+    healStage?: boolean;
+}): Promise<ReconcileResult>;