@dewtech/dare-cli 2.16.0 → 3.0.0

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"}

package/dist/utils/UpdateDetector.js

@@ -0,0 +1,164 @@
+/**
+ * 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 fs from 'fs-extra';
+import path from 'path';
+import crypto from 'crypto';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { compareVersions, isNewerThan, sortVersionsAscending, } from './version-compare.js';
+const require = createRequire(import.meta.url);
+/** Path to `templates/UPDATE-MANIFEST.json`, shipped with the CLI. */
+function getManifestPath() {
+    // `import.meta.url` resolves to .../dist/utils/UpdateDetector.js once built.
+    // The manifest lives at .../templates/UPDATE-MANIFEST.json, two levels up.
+    const here = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(here), '..', '..', 'templates', 'UPDATE-MANIFEST.json');
+}
+export async function loadManifest() {
+    const manifestPath = getManifestPath();
+    if (!(await fs.pathExists(manifestPath))) {
+        throw new Error(`UPDATE-MANIFEST.json not found at ${manifestPath}`);
+    }
+    const data = (await fs.readJSON(manifestPath));
+    if (data.schemaVersion !== 1) {
+        throw new Error(`Unsupported manifest schemaVersion ${data.schemaVersion} (this CLI understands 1).`);
+    }
+    return data;
+}
+/** Read the current CLI version from the bundled `package.json`. */
+export function getCliVersion() {
+    const pkg = require('../../package.json');
+    return pkg.version;
+}
+/**
+ * Legacy `dare init` versions (pre-2.17) wrote a hardcoded `"0.1.0"` placeholder
+ * that nothing read. Treat it as "this project was never tracked" — the update
+ * flow will assume the project is on 2.16.0 (the last release before this field
+ * carried meaning) and run the unification migration.
+ */
+const LEGACY_PLACEHOLDER_VERSION = '0.1.0';
+/** Baseline assumed for projects with the legacy placeholder or no `version`. */
+export 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 function resolveProjectVersion(cfg) {
+    const raw = cfg.version;
+    if (!raw || raw === LEGACY_PLACEHOLDER_VERSION) {
+        return { version: LEGACY_BASELINE_VERSION, isLegacy: true };
+    }
+    return { version: raw, isLegacy: false };
+}
+/** Load and return `dare.config.json` from the given project root. */
+export async function readProjectConfig(projectRoot) {
+    const configPath = path.join(projectRoot, 'dare.config.json');
+    if (!(await fs.pathExists(configPath))) {
+        throw new Error(`dare.config.json not found in ${projectRoot}. Is this a DARE project? Run \`dare init\` first.`);
+    }
+    return (await fs.readJSON(configPath));
+}
+/**
+ * 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 function changeAppliesToIde(change, ide) {
+    const targets = change.appliesTo ?? ['*'];
+    if (targets.includes('*'))
+        return true;
+    if (!ide)
+        return false;
+    if (targets.includes(ide))
+        return true;
+    // Hybrid expansions
+    if (ide === 'hybrid') {
+        return targets.includes('cursor') || targets.includes('antigravity');
+    }
+    if (ide === 'claude-hybrid') {
+        return targets.includes('claude-code') || targets.includes('cursor');
+    }
+    return false;
+}
+/**
+ * Build the update plan: every release between `from` (exclusive) and `to`
+ * (inclusive), with its changes filtered down to what applies to this IDE.
+ */
+export function buildUpdatePlan(manifest, fromVersion, toVersion, ide) {
+    const allVersions = Object.keys(manifest.releases);
+    const sorted = sortVersionsAscending(allVersions);
+    const pending = sorted.filter((v) => {
+        const newerThanFrom = isNewerThan(v, fromVersion);
+        const notNewerThanTo = compareVersions(v, toVersion) !== 1;
+        return newerThanFrom && notNewerThanTo;
+    });
+    const pendingReleases = pending.map((version) => ({
+        version,
+        release: manifest.releases[version],
+    }));
+    const applicableChanges = [];
+    for (const { release } of pendingReleases) {
+        for (const change of release.changes) {
+            if (changeAppliesToIde(change, ide)) {
+                applicableChanges.push(change);
+            }
+        }
+    }
+    return {
+        fromVersion,
+        toVersion,
+        pendingReleases,
+        applicableChanges,
+    };
+}
+/** SHA-256 hex digest of file content; returns `null` if the file is absent. */
+export async function hashFile(absPath) {
+    if (!(await fs.pathExists(absPath)))
+        return null;
+    const buf = await fs.readFile(absPath);
+    return crypto.createHash('sha256').update(buf).digest('hex');
+}
+/**
+ * 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 async function classifyChange(projectRoot, change, newContent) {
+    // Schema-only changes (path includes `#`) are handled by migrations,
+    // not by file copy. Treat them as `apply`.
+    if (change.path.includes('#'))
+        return 'apply';
+    const target = path.join(projectRoot, change.path);
+    const currentHash = await hashFile(target);
+    if (change.type === 'removed') {
+        return currentHash === null ? 'identical' : 'apply';
+    }
+    if (currentHash === null)
+        return 'missing';
+    if (newContent !== null) {
+        const newHash = crypto
+            .createHash('sha256')
+            .update(typeof newContent === 'string' ? Buffer.from(newContent) : newContent)
+            .digest('hex');
+        if (newHash === currentHash)
+            return 'identical';
+    }
+    if (change.previousHash && currentHash === change.previousHash) {
+        return 'apply';
+    }
+    return 'customized';
+}
+//# sourceMappingURL=UpdateDetector.js.map

package/dist/utils/UpdateDetector.js.map

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

package/dist/utils/banner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * DARE CLI — ASCII art banner
+ * Displayed on: dare (no args), dare new, dare --version, dare welcome
+ *
+ * Suppressed when:
+ *   - process.stdout.isTTY is false (pipe/redirect)
+ *   - DARE_NO_BANNER=1 env var
+ *   - --no-banner global flag
+ *
+ * License: MIT (D-001)
+ */
+/**
+ * Render the DARE ASCII art using the best available figlet font.
+ * Falls back through FONT_FALLBACKS until a non-empty result is obtained.
+ */
+export declare function renderBanner(): string;
+/**
+ * Print the DARE ASCII art banner to stdout.
+ *
+ * Respects suppression rules:
+ *   - !process.stdout.isTTY  → silent (unless FORCE_BANNER=1)
+ *   - DARE_NO_BANNER=1       → silent
+ *   - options.noColor=true   → ANSI green instead of truecolor gradient
+ */
+export declare function printBanner(options?: {
+    noColor?: boolean;
+}): void;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyBH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAUrC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CA0BrE"}

package/dist/utils/banner.js

@@ -0,0 +1,77 @@
+/**
+ * DARE CLI — ASCII art banner
+ * Displayed on: dare (no args), dare new, dare --version, dare welcome
+ *
+ * Suppressed when:
+ *   - process.stdout.isTTY is false (pipe/redirect)
+ *   - DARE_NO_BANNER=1 env var
+ *   - --no-banner global flag
+ *
+ * License: MIT (D-001)
+ */
+import figlet from 'figlet';
+import { createRequire } from 'module';
+// gradient-string is CommonJS — use createRequire for safe ESM interop
+const _require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+const gradient = _require('gradient-string');
+const { version } = _require('../../package.json');
+// Dewtech official green palette
+const DEWTECH_GREEN = gradient('#7FD93A', '#5BCB1B', '#3FA00C');
+const FONT_FALLBACKS = [
+    'Alligator',
+    'Larry 3D',
+    'Big',
+    'Slant',
+    'Standard',
+];
+/**
+ * Render the DARE ASCII art using the best available figlet font.
+ * Falls back through FONT_FALLBACKS until a non-empty result is obtained.
+ */
+export function renderBanner() {
+    for (const font of FONT_FALLBACKS) {
+        try {
+            const art = figlet.textSync('DARE', { font, horizontalLayout: 'default' });
+            if (art && art.trim().length > 0)
+                return art;
+        }
+        catch {
+            // try next font
+        }
+    }
+    return 'DARE'; // ultimate plain-text fallback
+}
+/**
+ * Print the DARE ASCII art banner to stdout.
+ *
+ * Respects suppression rules:
+ *   - !process.stdout.isTTY  → silent (unless FORCE_BANNER=1)
+ *   - DARE_NO_BANNER=1       → silent
+ *   - options.noColor=true   → ANSI green instead of truecolor gradient
+ */
+export function printBanner(options = {}) {
+    // TTY guard: skip in pipes/redirects unless explicitly forced (e.g. dare welcome)
+    if (!process.stdout.isTTY && process.env.FORCE_BANNER !== '1')
+        return;
+    // Env-var suppression
+    if (process.env.DARE_NO_BANNER === '1')
+        return;
+    const banner = renderBanner();
+    const tagline = '  Design · Architecture · Review · Execute';
+    const subtitle = `  by Dewtech · dewtech.tech  v${version}`;
+    // Colour detection: use truecolor gradient when COLORTERM is set, else basic ANSI green
+    const supportsColor = !options.noColor &&
+        (process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit');
+    if (supportsColor) {
+        console.log(DEWTECH_GREEN.multiline(banner));
+    }
+    else {
+        // Fallback: basic ANSI green (works in all terminals)
+        console.log('\x1b[32m' + banner + '\x1b[0m');
+    }
+    console.log('\x1b[90m' + tagline + '\x1b[0m'); // dim grey
+    console.log('\x1b[90m' + subtitle + '\x1b[0m');
+    console.log();
+}
+//# sourceMappingURL=banner.js.map

package/dist/utils/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,MAAyB,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,uEAAuE;AACvE,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,mEAAmE;AACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAEC,CAAC;AAE7C,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,oBAAoB,CAAwB,CAAC;AAE1E,iCAAiC;AACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAEhE,MAAM,cAAc,GAAe;IACjC,WAAW;IACX,UAAU;IACV,KAAK;IACL,OAAO;IACP,UAAU;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC;YAC3E,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,+BAA+B;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,UAAiC,EAAE;IAC7D,kFAAkF;IAClF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG;QAAE,OAAO;IAEtE,sBAAsB;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG;QAAE,OAAO;IAE/C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,4CAA4C,CAAC;IAC7D,MAAM,QAAQ,GAAG,iCAAiC,OAAO,EAAE,CAAC;IAE5D,wFAAwF;IACxF,MAAM,aAAa,GACjB,CAAC,OAAO,CAAC,OAAO;QAChB,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC;IAE/E,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,sDAAsD;QACtD,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW;IAC1D,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/utils/banner.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for DARE CLI — ASCII art banner (printBanner / renderBanner)
+ */
+export {};
+//# sourceMappingURL=banner.spec.d.ts.map

package/dist/utils/banner.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.spec.d.ts","sourceRoot":"","sources":["../../src/utils/banner.spec.ts"],"names":[],"mappings":"AAAA;;GAEG"}