@dewtech/dare-cli 2.15.0 → 2.17.0

package/dist/utils/ReviewRunner.js

@@ -0,0 +1,175 @@
+/**
+ * Orchestrates `dare review`:
+ *   1. Resolve the task spec from `DARE/EXECUTION/task-<id>.md` (or other
+ *      common locations).
+ *   2. Discover which files the task touched — by parsing the spec's
+ *      "ARQUIVOS A CRIAR / MODIFICAR" table, falling back to `git diff`
+ *      against the merge base when the spec doesn't list files.
+ *   3. Run the static analyzer over those files.
+ *   4. Optionally merge a `SemanticVerdict` provided by the IDE agent
+ *      (via `--from-agent <path>`).
+ *
+ * Pure data manipulation — file I/O happens through `fs-extra` and `child_process`.
+ * The CLI command (`commands/review.ts`) wraps this with chalk output.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execFileSync } from 'child_process';
+import { runStaticAnalysis } from './static-analyzer.js';
+/** Candidate locations of a task spec, tried in order. */
+function specCandidates(projectRoot, taskId) {
+    return [
+        path.join(projectRoot, 'DARE', 'EXECUTION', `${taskId}.md`),
+        path.join(projectRoot, 'DARE', 'EXECUTION', `task-${taskId}.md`),
+        path.join(projectRoot, 'DARE', 'tasks', `${taskId}.md`),
+        path.join(projectRoot, 'DARE', `${taskId}.md`),
+    ];
+}
+export async function findSpecFile(projectRoot, taskId) {
+    for (const candidate of specCandidates(projectRoot, taskId)) {
+        if (await fs.pathExists(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Parse the "ARQUIVOS A CRIAR / MODIFICAR" markdown table from a spec.
+ *
+ * Expected shape (from `TASK-SPEC-template.md`):
+ *
+ *   | Ação | Caminho | Descrição |
+ *   |------|---------|-----------|
+ *   | CRIAR | `src/foo.ts` | ... |
+ *   | MODIFICAR | `src/bar.ts` | ... |
+ *
+ * We grab anything in backticks within rows where the first column is
+ * CRIAR/MODIFICAR/CREATE/MODIFY/UPDATE. Returns project-relative paths.
+ */
+export function parseFilesFromSpec(specMarkdown) {
+    const lines = specMarkdown.split(/\r?\n/);
+    const out = [];
+    const actionRe = /^\|\s*(CRIAR|MODIFICAR|CREATE|MODIFY|UPDATE|TOUCH)\s*\|/i;
+    const pathRe = /`([^`]+)`/;
+    for (const line of lines) {
+        if (!actionRe.test(line))
+            continue;
+        const m = pathRe.exec(line);
+        if (!m)
+            continue;
+        const filePath = m[1].trim();
+        // Filter obvious non-file references (directories, comments).
+        if (!filePath || filePath.endsWith('/') || filePath.startsWith('['))
+            continue;
+        out.push(filePath);
+    }
+    // De-dupe while preserving order.
+    return Array.from(new Set(out));
+}
+/**
+ * Fallback: ask git which files diverge from the merge base with the default
+ * branch. Returns project-relative paths; on any git error, returns `[]`
+ * silently — the caller is expected to surface a friendlier message.
+ */
+export function discoverFilesFromGit(projectRoot) {
+    try {
+        const baseRef = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: projectRoot,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .trim();
+        // Diff vs HEAD~1 if no merge-base is sensible — best-effort.
+        const out = execFileSync('git', ['diff', '--name-only', 'HEAD', '--', '.'], { cwd: projectRoot, stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+        if (!out)
+            return [];
+        return out
+            .split('\n')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        void baseRef; // (silence unused-warning when only diff matters)
+    }
+    catch {
+        return [];
+    }
+}
+/** Build the empty-shell report when there are no files to scan. */
+function emptyReport(taskId) {
+    return {
+        taskId,
+        filesScanned: [],
+        reports: [],
+        failed: false,
+        totals: { errors: 0, warnings: 0, filesWithFindings: 0 },
+    };
+}
+/** Read the optional semantic verdict supplied by the IDE agent. */
+async function loadSemanticVerdict(fromAgentPath) {
+    if (!(await fs.pathExists(fromAgentPath))) {
+        throw new Error(`--from-agent file not found: ${fromAgentPath}`);
+    }
+    const data = await fs.readJSON(fromAgentPath);
+    if (typeof data?.passed !== 'boolean' || !Array.isArray(data?.unmetCriteria)) {
+        throw new Error(`Invalid semantic verdict in ${fromAgentPath}: needs { passed: boolean, unmetCriteria: string[] }.`);
+    }
+    return data;
+}
+/**
+ * Main entry point. Resolves files, runs the analyzer, merges semantic input
+ * if any, and returns a fully populated `ReviewReport`.
+ */
+export async function runReview(taskId, options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    // 1. Resolve file list.
+    let files = options.files ?? [];
+    if (files.length === 0) {
+        const specPath = await findSpecFile(projectRoot, taskId);
+        if (specPath) {
+            const md = await fs.readFile(specPath, 'utf-8');
+            files = parseFilesFromSpec(md);
+        }
+    }
+    if (files.length === 0) {
+        // Last-ditch: try git.
+        files = discoverFilesFromGit(projectRoot);
+    }
+    if (files.length === 0) {
+        return emptyReport(taskId);
+    }
+    // 2. Run analyzer.
+    const reports = await runStaticAnalysis(projectRoot, files);
+    // 3. Aggregate totals.
+    let errors = 0;
+    let warnings = 0;
+    let filesWithFindings = 0;
+    for (const r of reports) {
+        if (r.violations.length === 0)
+            continue;
+        filesWithFindings++;
+        for (const v of r.violations) {
+            if (v.severity === 'error')
+                errors++;
+            else
+                warnings++;
+        }
+    }
+    // 4. Optional semantic merge.
+    let semantic;
+    if (options.fromAgent) {
+        const v = await loadSemanticVerdict(options.fromAgent);
+        if (v)
+            semantic = v;
+    }
+    const failedFromStatic = errors > 0 || (Boolean(options.strict) && warnings > 0);
+    const failedFromSemantic = semantic ? !semantic.passed : false;
+    return {
+        taskId,
+        filesScanned: files,
+        reports,
+        failed: failedFromStatic || failedFromSemantic,
+        totals: { errors, warnings, filesWithFindings },
+        semantic,
+    };
+}
+//# sourceMappingURL=ReviewRunner.js.map

package/dist/utils/ReviewRunner.js.map

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

package/dist/utils/UpdateApplier.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Applies an `UpdatePlan` to a project on disk.
+ *
+ * The detector decides *what* would happen; the applier actually writes files,
+ * backs up the previous state, prompts on conflicts and runs migrations. Kept
+ * separate so unit tests can poke the detector without touching the filesystem.
+ */
+import type { ConflictResolution, ManifestChange, ManifestMigration, UpdatePlan } from '../types/UpdateManifest.types.js';
+/** Per-file outcome used to build the final summary. */
+export interface ChangeOutcome {
+    change: ManifestChange;
+    resolution: ConflictResolution;
+    action: 'wrote' | 'deleted' | 'skipped' | 'kept-custom';
+}
+export interface ApplyOptions {
+    projectRoot: string;
+    /** Backup directory inside the project (defaults to `.dare/backup-<from>`). */
+    backupDir?: string;
+    /** Skip interactive prompts and always overwrite customizations. Dangerous. */
+    force?: boolean;
+    /** Print plan but write nothing. */
+    dryRun?: boolean;
+    /** Default answer for the per-file conflict prompt — `'ask'` is interactive. */
+    conflictPolicy?: 'ask' | 'keep' | 'replace';
+}
+/**
+ * Snapshot every file the plan touches into `backupDir`, preserving its
+ * relative path. Touches only files that currently exist.
+ */
+export declare function backupAffectedFiles(plan: UpdatePlan, projectRoot: string, backupDir: string): Promise<number>;
+export interface ApplyResult {
+    outcomes: ChangeOutcome[];
+    migrationsRan: ManifestMigration[];
+    backupPath: string | null;
+    backupFilesCount: number;
+}
+/**
+ * Execute the plan. Returns a structured result so the command can print a
+ * sensible summary at the end.
+ */
+export declare function applyPlan(plan: UpdatePlan, options: ApplyOptions): Promise<ApplyResult>;
+//# sourceMappingURL=UpdateApplier.d.ts.map

package/dist/utils/UpdateApplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateApplier.d.ts","sourceRoot":"","sources":["../../src/utils/UpdateApplier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACX,MAAM,kCAAkC,CAAC;AA6B1C,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAYjB;AA8JD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAgCtB"}

package/dist/utils/UpdateApplier.js

@@ -0,0 +1,207 @@
+/**
+ * Applies an `UpdatePlan` to a project on disk.
+ *
+ * The detector decides *what* would happen; the applier actually writes files,
+ * backs up the previous state, prompts on conflicts and runs migrations. Kept
+ * separate so unit tests can poke the detector without touching the filesystem.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { fileURLToPath } from 'url';
+import { classifyChange, readProjectConfig } from './UpdateDetector.js';
+/** Where templates ship inside the CLI bundle. */
+function getTemplatesRoot() {
+    const here = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(here), '..', '..', 'templates');
+}
+/** Resolve the template source for a change (defaults to mirroring `path`). */
+function resolveTemplateSource(change) {
+    const rel = change.templateSource ?? change.path;
+    return path.join(getTemplatesRoot(), rel);
+}
+/** Read the new template content for a non-schema change. */
+async function readNewContent(change) {
+    if (change.path.includes('#'))
+        return null; // schema-only
+    if (change.type === 'removed')
+        return null;
+    const source = resolveTemplateSource(change);
+    if (!(await fs.pathExists(source))) {
+        throw new Error(`Template source missing for change "${change.path}" (expected at ${source}). ` +
+            `Make sure the manifest's templateSource is correct or that templates/ ships the file.`);
+    }
+    return fs.readFile(source);
+}
+/**
+ * Snapshot every file the plan touches into `backupDir`, preserving its
+ * relative path. Touches only files that currently exist.
+ */
+export async function backupAffectedFiles(plan, projectRoot, backupDir) {
+    let copied = 0;
+    for (const change of plan.applicableChanges) {
+        if (change.path.includes('#'))
+            continue;
+        const src = path.join(projectRoot, change.path);
+        if (!(await fs.pathExists(src)))
+            continue;
+        const dest = path.join(backupDir, change.path);
+        await fs.ensureDir(path.dirname(dest));
+        await fs.copy(src, dest);
+        copied++;
+    }
+    return copied;
+}
+/**
+ * Prompt the dev on a customized file. Returns the action to take.
+ *
+ * Honors `conflictPolicy` to skip the prompt in non-interactive flows
+ * (CI, scripted updates) — `'keep'` preserves the local file, `'replace'`
+ * overwrites it.
+ */
+async function resolveCustomization(change, conflictPolicy) {
+    if (conflictPolicy !== 'ask')
+        return conflictPolicy;
+    const { decision } = (await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'decision',
+            message: `Arquivo customizado: ${chalk.yellow(change.path)}\n  ${chalk.gray(change.description)}`,
+            choices: [
+                { name: '🔒 Manter minha versão (recomendado se você editou)', value: 'keep' },
+                { name: '⬆️  Substituir pela versão nova do DARE', value: 'replace' },
+            ],
+            default: 'keep',
+        },
+    ]));
+    return decision;
+}
+async function applyOne(change, projectRoot, conflictPolicy, dryRun) {
+    // Schema-only ("dare.config.json#field") — migrations handle these.
+    if (change.path.includes('#')) {
+        return { change, resolution: 'apply', action: 'skipped' };
+    }
+    const target = path.join(projectRoot, change.path);
+    const newContent = await readNewContent(change);
+    const resolution = await classifyChange(projectRoot, change, newContent);
+    if (resolution === 'identical') {
+        return { change, resolution, action: 'skipped' };
+    }
+    if (change.type === 'removed') {
+        if (!dryRun && (await fs.pathExists(target))) {
+            await fs.remove(target);
+        }
+        return { change, resolution, action: 'deleted' };
+    }
+    if (resolution === 'customized') {
+        const decision = await resolveCustomization(change, conflictPolicy);
+        if (decision === 'keep') {
+            return { change, resolution, action: 'kept-custom' };
+        }
+    }
+    if (change.type === 'renamed' && change.previousPath) {
+        const prev = path.join(projectRoot, change.previousPath);
+        if (!dryRun && (await fs.pathExists(prev))) {
+            await fs.remove(prev);
+        }
+    }
+    if (newContent && !dryRun) {
+        await fs.ensureDir(path.dirname(target));
+        await fs.writeFile(target, newContent);
+    }
+    return { change, resolution, action: 'wrote' };
+}
+/** Run all migrations declared in the plan (post file changes). */
+async function runMigrations(plan, projectRoot, dryRun) {
+    const ran = [];
+    for (const { release } of plan.pendingReleases) {
+        if (!release.migrations)
+            continue;
+        for (const migration of release.migrations) {
+            if (dryRun) {
+                ran.push(migration);
+                continue;
+            }
+            await runMigration(migration, projectRoot);
+            ran.push(migration);
+        }
+    }
+    return ran;
+}
+/**
+ * Built-in migrations. Each `id` maps to a handler — unknown ids are skipped
+ * with a warning so an older CLI can still apply a partial update.
+ */
+async function runMigration(migration, projectRoot) {
+    switch (migration.id) {
+        case 'unify-version-field': {
+            // Pre-2.17 projects wrote `version: "0.1.0"` (zombie placeholder) and
+            // an early prototype briefly used `dareVersion`. Consolidate both into
+            // a single `version` field that now tracks the DARE release.
+            const configPath = path.join(projectRoot, 'dare.config.json');
+            const cfg = (await readProjectConfig(projectRoot));
+            const legacyDareVersion = cfg.dareVersion;
+            if (legacyDareVersion) {
+                cfg.version = legacyDareVersion;
+                delete cfg.dareVersion;
+            }
+            else if (!cfg.version || cfg.version === '0.1.0') {
+                cfg.version = '2.16.0';
+            }
+            await fs.writeJSON(configPath, cfg, { spaces: 2 });
+            return;
+        }
+        case 'add-review-refine-defaults': {
+            // Seed the new review/refine objects so dev can see they exist (and
+            // edit). Opt-in stance for legacy projects — review.onComplete: false
+            // means the gate is silent until the dev flips it.
+            const configPath = path.join(projectRoot, 'dare.config.json');
+            const cfg = (await readProjectConfig(projectRoot));
+            if (!cfg.review) {
+                cfg.review = { onComplete: false, strict: false };
+            }
+            if (!cfg.refine) {
+                cfg.refine = { thresholds: { low: 5, med: 12, high: 20 } };
+            }
+            await fs.writeJSON(configPath, cfg, { spaces: 2 });
+            return;
+        }
+        default:
+            console.log(chalk.yellow(`  ⚠  Unknown migration "${migration.id}" — skipping (CLI may be outdated).`));
+    }
+}
+/** Bump `version` in `dare.config.json` to the plan's target version. */
+async function stampVersion(projectRoot, toVersion) {
+    const configPath = path.join(projectRoot, 'dare.config.json');
+    const cfg = (await readProjectConfig(projectRoot));
+    cfg.version = toVersion;
+    cfg.updatedAt = new Date().toISOString();
+    await fs.writeJSON(configPath, cfg, { spaces: 2 });
+}
+/**
+ * Execute the plan. Returns a structured result so the command can print a
+ * sensible summary at the end.
+ */
+export async function applyPlan(plan, options) {
+    const { projectRoot, backupDir, force = false, dryRun = false, conflictPolicy = force ? 'replace' : 'ask', } = options;
+    let backupPath = null;
+    let backupFilesCount = 0;
+    if (!dryRun) {
+        backupPath =
+            backupDir ?? path.join(projectRoot, '.dare', `backup-${plan.fromVersion}`);
+        await fs.ensureDir(backupPath);
+        backupFilesCount = await backupAffectedFiles(plan, projectRoot, backupPath);
+    }
+    const outcomes = [];
+    for (const change of plan.applicableChanges) {
+        const outcome = await applyOne(change, projectRoot, conflictPolicy, dryRun);
+        outcomes.push(outcome);
+    }
+    const migrationsRan = await runMigrations(plan, projectRoot, dryRun);
+    if (!dryRun) {
+        await stampVersion(projectRoot, plan.toVersion);
+    }
+    return { outcomes, migrationsRan, backupPath, backupFilesCount };
+}
+//# sourceMappingURL=UpdateApplier.js.map

package/dist/utils/UpdateApplier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateApplier.js","sourceRoot":"","sources":["../../src/utils/UpdateApplier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAOpC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExE,kDAAkD;AAClD,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,SAAS,qBAAqB,CAAC,MAAsB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,6DAA6D;AAC7D,KAAK,UAAU,cAAc,CAAC,MAAsB;IAClD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,cAAc;IAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,IAAI,kBAAkB,MAAM,KAAK;YAC7E,uFAAuF,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAqBD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAgB,EAChB,WAAmB,EACnB,SAAiB;IAEjB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC;IACX,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,oBAAoB,CACjC,MAAsB,EACtB,cAA0C;IAE1C,IAAI,cAAc,KAAK,KAAK;QAAE,OAAO,cAAc,CAAC;IAEpD,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC1C;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,wBAAwB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;YACjG,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,qDAAqD,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC9E,EAAE,IAAI,EAAE,yCAAyC,EAAE,KAAK,EAAE,SAAS,EAAE;aACtE;YACD,OAAO,EAAE,MAAM;SAChB;KACF,CAAC,CAAqC,CAAC;IAExC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,MAAsB,EACtB,WAAmB,EACnB,cAA0C,EAC1C,MAAe;IAEf,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAEzE,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,mEAAmE;AACnE,KAAK,UAAU,aAAa,CAC1B,IAAgB,EAChB,WAAmB,EACnB,MAAe;IAEf,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,UAAU;YAAE,SAAS;QAClC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,MAAM,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,YAAY,CACzB,SAA4B,EAC5B,WAAmB;IAEnB,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,sEAAsE;YACtE,uEAAuE;YACvE,6DAA6D;YAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAA4B,CAAC;YAC9E,MAAM,iBAAiB,GAAG,GAAG,CAAC,WAAiC,CAAC;YAChE,IAAI,iBAAiB,EAAE,CAAC;gBACtB,GAAG,CAAC,OAAO,GAAG,iBAAiB,CAAC;gBAChC,OAAO,GAAG,CAAC,WAAW,CAAC;YACzB,CAAC;iBAAM,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACnD,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC;YACzB,CAAC;YACD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,KAAK,4BAA4B,CAAC,CAAC,CAAC;YAClC,oEAAoE;YACpE,sEAAsE;YACtE,mDAAmD;YACnD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAA4B,CAAC;YAC9E,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,MAAM,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACpD,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,MAAM,GAAG,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;YAC7D,CAAC;YACD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD;YACE,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,2BAA2B,SAAS,CAAC,EAAE,qCAAqC,CAC7E,CACF,CAAC;IACN,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAiB;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAA4B,CAAC;IAC9E,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC;IACxB,GAAG,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAgB,EAChB,OAAqB;IAErB,MAAM,EACJ,WAAW,EACX,SAAS,EACT,KAAK,GAAG,KAAK,EACb,MAAM,GAAG,KAAK,EACd,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAC3C,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,UAAU;YACR,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/B,gBAAgB,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;QAC5E,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAErE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACnE,CAAC"}

package/dist/utils/UpdateDetector.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Detects what `dare update` needs to do for a given project.
+ *
+ * Pure planning — it never writes to disk. Loads the manifest, reads the
+ * project's `dare.config.json`, and produces an `UpdatePlan` the applier can
+ * execute (or the dev can simply preview with `--dry-run`).
+ */
+import type { ConflictResolution, ManifestChange, UpdateManifest, UpdatePlan } from '../types/UpdateManifest.types.js';
+export declare function loadManifest(): Promise<UpdateManifest>;
+/** Read the current CLI version from the bundled `package.json`. */
+export declare function getCliVersion(): string;
+export interface ProjectConfig {
+    ide?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/** Baseline assumed for projects with the legacy placeholder or no `version`. */
+export declare const LEGACY_BASELINE_VERSION = "2.16.0";
+/**
+ * Resolve the "effective DARE version" of a project, handling the legacy
+ * `"0.1.0"` placeholder that was hardcoded by pre-2.17 `dare init`.
+ */
+export declare function resolveProjectVersion(cfg: ProjectConfig): {
+    version: string;
+    isLegacy: boolean;
+};
+/** Load and return `dare.config.json` from the given project root. */
+export declare function readProjectConfig(projectRoot: string): Promise<ProjectConfig>;
+/**
+ * Filter a single change against the IDE configured for this project. A change
+ * with `appliesTo: ['*']` (or no `appliesTo`) is universal.
+ *
+ * Hybrid setups (`hybrid` = cursor+antigravity, `claude-hybrid` = claude+cursor)
+ * accept changes targeted at any of their member IDEs.
+ */
+export declare function changeAppliesToIde(change: ManifestChange, ide: string | undefined): boolean;
+/**
+ * Build the update plan: every release between `from` (exclusive) and `to`
+ * (inclusive), with its changes filtered down to what applies to this IDE.
+ */
+export declare function buildUpdatePlan(manifest: UpdateManifest, fromVersion: string, toVersion: string, ide: string | undefined): UpdatePlan;
+/** SHA-256 hex digest of file content; returns `null` if the file is absent. */
+export declare function hashFile(absPath: string): Promise<string | null>;
+/**
+ * Classify what we'd be doing to a single file on disk:
+ *   - `identical`  → new template content already matches what's on disk
+ *   - `missing`    → file absent in the project, safe to create
+ *   - `apply`      → file present and matches `previousHash`, safe to overwrite
+ *   - `customized` → file present but doesn't match `previousHash`; ask the dev
+ *
+ * `newContent` is the bytes we'd write; `previousHash` is the manifest's record
+ * of what the file looked like in the prior version (optional — without it we
+ * can't tell `apply` from `customized` and conservatively return `customized`).
+ */
+export declare function classifyChange(projectRoot: string, change: ManifestChange, newContent: Buffer | string | null): Promise<ConflictResolution>;
+//# sourceMappingURL=UpdateDetector.d.ts.map

package/dist/utils/UpdateDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateDetector.d.ts","sourceRoot":"","sources":["../../src/utils/UpdateDetector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EACV,kBAAkB,EAElB,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,kCAAkC,CAAC;AAiB1C,wBAAsB,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CAY5D;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAMA;AAED,sEAAsE;AACtE,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQnF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAe3F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,UAAU,CA8BZ;AAED,gFAAgF;AAChF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAItE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GACjC,OAAO,CAAC,kBAAkB,CAAC,CA2B7B"}