@quickback-dev/cli 0.10.2 → 0.10.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/dist/commands/compile.d.ts +9 -1
  2. package/dist/commands/compile.d.ts.map +1 -1
  3. package/dist/commands/compile.js +44 -13
  4. package/dist/commands/compile.js.map +1 -1
  5. package/dist/commands/init.d.ts.map +1 -1
  6. package/dist/commands/init.js +22 -0
  7. package/dist/commands/init.js.map +1 -1
  8. package/dist/cursor/quickback.mdc +24 -13
  9. package/dist/docs/content.js +11 -11
  10. package/dist/docs/content.js.map +1 -1
  11. package/dist/index.js +3 -2
  12. package/dist/index.js.map +1 -1
  13. package/dist/lib/api-client.d.ts +15 -0
  14. package/dist/lib/api-client.d.ts.map +1 -1
  15. package/dist/lib/api-client.js +31 -2
  16. package/dist/lib/api-client.js.map +1 -1
  17. package/dist/lib/api-client.test.js +58 -0
  18. package/dist/lib/api-client.test.js.map +1 -1
  19. package/dist/lib/config-sync.d.ts +55 -0
  20. package/dist/lib/config-sync.d.ts.map +1 -0
  21. package/dist/lib/config-sync.js +207 -0
  22. package/dist/lib/config-sync.js.map +1 -0
  23. package/dist/lib/config-sync.test.d.ts +2 -0
  24. package/dist/lib/config-sync.test.d.ts.map +1 -0
  25. package/dist/lib/config-sync.test.js +151 -0
  26. package/dist/lib/config-sync.test.js.map +1 -0
  27. package/dist/lib/prepare-output.d.ts +31 -0
  28. package/dist/lib/prepare-output.d.ts.map +1 -0
  29. package/dist/lib/prepare-output.js +95 -0
  30. package/dist/lib/prepare-output.js.map +1 -0
  31. package/dist/lib/prepare-output.test.d.ts +2 -0
  32. package/dist/lib/prepare-output.test.d.ts.map +1 -0
  33. package/dist/lib/prepare-output.test.js +105 -0
  34. package/dist/lib/prepare-output.test.js.map +1 -0
  35. package/dist/lib/sweep-stale.d.ts +25 -0
  36. package/dist/lib/sweep-stale.d.ts.map +1 -0
  37. package/dist/lib/sweep-stale.js +179 -0
  38. package/dist/lib/sweep-stale.js.map +1 -0
  39. package/dist/lib/sweep-stale.test.d.ts +2 -0
  40. package/dist/lib/sweep-stale.test.d.ts.map +1 -0
  41. package/dist/lib/sweep-stale.test.js +130 -0
  42. package/dist/lib/sweep-stale.test.js.map +1 -0
  43. package/dist/skill/SKILL.md +245 -52
  44. package/dist/skill/agents/quickback-specialist/AGENT.md +42 -36
  45. package/package.json +1 -1
  46. package/src/cursor/quickback.mdc +24 -13
  47. package/src/skill/SKILL.md +245 -52
  48. package/src/skill/agents/quickback-specialist/AGENT.md +42 -36
@@ -0,0 +1,151 @@
1
+ import { describe, expect, it } from 'bun:test';
2
+ import { applySync } from './config-sync.js';
3
+ const NEW_BLOCK = [
4
+ ' // [quickback:options-start]',
5
+ ' // ── new content ──',
6
+ ' // openapi: { generate: true, publish: true },',
7
+ ' // [quickback:options-end]',
8
+ ].join('\n');
9
+ describe('config-sync applySync', () => {
10
+ // User story: As a Quickback user with an existing config containing the marker block, I need
11
+ // the kitchen-sink to be refreshed wholesale every compile so newly added options surface
12
+ // immediately without me having to upgrade my CLI.
13
+ it('replaces the body between markers without touching surrounding code', () => {
14
+ const original = [
15
+ 'export default defineConfig({',
16
+ ' name: "demo",',
17
+ ' template: "hono",',
18
+ ' providers: cloudflare({}),',
19
+ '',
20
+ ' // [quickback:options-start]',
21
+ ' // outdated content',
22
+ ' // foo: { bar: true },',
23
+ ' // [quickback:options-end]',
24
+ '});',
25
+ '',
26
+ ].join('\n');
27
+ const { text, inserted, skippedReason } = applySync(original, NEW_BLOCK);
28
+ expect(skippedReason).toBeUndefined();
29
+ expect(inserted).toBe(false);
30
+ expect(text).toContain('name: "demo",');
31
+ expect(text).toContain('// ── new content ──');
32
+ expect(text).not.toContain('outdated content');
33
+ // Surrounding lines are preserved verbatim
34
+ expect(text.startsWith('export default defineConfig({')).toBe(true);
35
+ expect(text.endsWith('});\n')).toBe(true);
36
+ });
37
+ // User story: As a Quickback user with a legacy config that pre-dates the marker convention,
38
+ // I need the first compile to insert the marker block automatically just inside the closing
39
+ // }) of defineConfig so I do not have to hand-edit the file.
40
+ it('inserts marker block before the closing `})` when sentinels are absent', () => {
41
+ const original = [
42
+ 'export default defineConfig({',
43
+ ' name: "demo",',
44
+ ' template: "hono",',
45
+ ' providers: cloudflare({}),',
46
+ '});',
47
+ '',
48
+ ].join('\n');
49
+ const { text, inserted, skippedReason } = applySync(original, NEW_BLOCK);
50
+ expect(skippedReason).toBeUndefined();
51
+ expect(inserted).toBe(true);
52
+ expect(text).toContain('// [quickback:options-start]');
53
+ expect(text).toContain('// [quickback:options-end]');
54
+ // The block sits before the closing brace, not after the file ends
55
+ const blockIdx = text.indexOf('// [quickback:options-start]');
56
+ const closeIdx = text.indexOf('});');
57
+ expect(blockIdx).toBeLessThan(closeIdx);
58
+ });
59
+ // User story: As a Quickback user, I need a no-op compile to not rewrite my config so file
60
+ // mtimes stay stable and editors do not flag a phantom change after every compile.
61
+ it('returns identical text when the block is already up to date', () => {
62
+ const original = [
63
+ 'export default defineConfig({',
64
+ ' name: "demo",',
65
+ ' template: "hono",',
66
+ ' providers: cloudflare({}),',
67
+ '',
68
+ ' // [quickback:options-start]',
69
+ ' // ── new content ──',
70
+ ' // openapi: { generate: true, publish: true },',
71
+ ' // [quickback:options-end]',
72
+ '});',
73
+ '',
74
+ ].join('\n');
75
+ const { text } = applySync(original, NEW_BLOCK);
76
+ expect(text).toBe(original);
77
+ });
78
+ // User story: As a Quickback user who half-deleted the markers by accident, I need the sync
79
+ // step to refuse to rewrite the file rather than guess where the block ends, so I can fix
80
+ // the file by hand without losing surrounding content.
81
+ it('refuses to overwrite when only one sentinel is present', () => {
82
+ const original = [
83
+ 'export default defineConfig({',
84
+ ' name: "demo",',
85
+ ' providers: cloudflare({}),',
86
+ ' // [quickback:options-start]',
87
+ ' // some leftover content with no end sentinel',
88
+ '});',
89
+ ].join('\n');
90
+ const { text, skippedReason } = applySync(original, NEW_BLOCK);
91
+ expect(text).toBe(original);
92
+ expect(skippedReason).toBeDefined();
93
+ expect(skippedReason).toContain('one sentinel');
94
+ });
95
+ // User story: As a Quickback user whose config does not call defineConfig (e.g. a hand-rolled
96
+ // object literal export), I need the sync step to skip rather than corrupt the file.
97
+ it('skips when defineConfig is not present', () => {
98
+ const original = 'export default { name: "demo" };\n';
99
+ const { text, inserted, skippedReason } = applySync(original, NEW_BLOCK);
100
+ expect(text).toBe(original);
101
+ expect(inserted).toBe(false);
102
+ expect(skippedReason).toContain('defineConfig');
103
+ });
104
+ // User story: As a Quickback user whose config has nested parentheses inside provider calls
105
+ // (preset functions, helper expressions, etc.), I need the closing-brace detection to find
106
+ // the *outer* `})` of defineConfig and not stop at the first nested `)`.
107
+ it('matches the outer closing `)` even when defineConfig contains nested calls', () => {
108
+ const original = [
109
+ 'export default defineConfig({',
110
+ ' name: "demo",',
111
+ ' providers: cloudflare({ extras: foo({ bar: 1 }) }),',
112
+ ' auth: { roleHierarchy: ["a", "b"] },',
113
+ '});',
114
+ ].join('\n');
115
+ const { text, inserted } = applySync(original, NEW_BLOCK);
116
+ expect(inserted).toBe(true);
117
+ // Block should land before the final }) — there is exactly one
118
+ expect(text.indexOf('// [quickback:options-start]')).toBeGreaterThan(text.indexOf('cloudflare('));
119
+ expect(text.indexOf('// [quickback:options-end]')).toBeLessThan(text.indexOf('});'));
120
+ });
121
+ // User story: As a Quickback user, I need parens that appear inside string literals (e.g.
122
+ // a regex-like default value or a Better Auth callback URL with `?redirect=(...)`) to be
123
+ // ignored by the brace counter so the block lands at the real outer closing.
124
+ it('ignores parens inside string literals when finding the outer closing', () => {
125
+ const original = [
126
+ 'export default defineConfig({',
127
+ ' name: "demo",',
128
+ ' auth: { redirect: "/cb?next=(home)" },',
129
+ '});',
130
+ ].join('\n');
131
+ const { text, inserted } = applySync(original, NEW_BLOCK);
132
+ expect(inserted).toBe(true);
133
+ // The string literal should not have been treated as a paren scope
134
+ expect(text).toContain('"/cb?next=(home)"');
135
+ });
136
+ // User story: As a Quickback user, I need parens in line comments (e.g. JSDoc-style notes
137
+ // describing example payloads) to be ignored so the block placement is not thrown off by
138
+ // human-friendly commentary.
139
+ it('ignores parens inside line comments when finding the outer closing', () => {
140
+ const original = [
141
+ 'export default defineConfig({',
142
+ ' name: "demo", // example: defineConfig(legacy)',
143
+ ' providers: cloudflare({}),',
144
+ '});',
145
+ ].join('\n');
146
+ const { text, inserted } = applySync(original, NEW_BLOCK);
147
+ expect(inserted).toBe(true);
148
+ expect(text).toContain('example: defineConfig(legacy)');
149
+ });
150
+ });
151
+ //# sourceMappingURL=config-sync.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-sync.test.js","sourceRoot":"","sources":["../../src/lib/config-sync.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ export interface PrepareOptions {
2
+ /**
3
+ * Where to archive the existing target dir before wiping. If unset,
4
+ * the wipe still happens but no archive is taken — only do this when
5
+ * you have an external recovery path.
6
+ */
7
+ archiveDir?: string;
8
+ /** How many archives to retain. Defaults to 3. */
9
+ archiveKeep?: number;
10
+ }
11
+ export interface PrepareResult {
12
+ /** True when the existing target dir was wiped. */
13
+ wiped: boolean;
14
+ /** Path to the archive snapshot, when one was taken. */
15
+ archivePath?: string;
16
+ /** Reason wiping was skipped (when applicable). */
17
+ skipped?: 'no-existing-tree' | 'empty-manifest';
18
+ }
19
+ /**
20
+ * Archive then wipe the target dir, in preparation for a fresh write.
21
+ *
22
+ * `manifest` is the full set of paths the compiler intends to write
23
+ * (relative to outputDir). It's used as a sanity check — if the
24
+ * manifest contains *no* files under targetDir we treat that as a
25
+ * compile bug and skip the destructive step.
26
+ *
27
+ * The wipe itself is a single fs.rm({recursive:true}) — fast, total,
28
+ * and matches the documented contract that src/ is compiler-owned.
29
+ */
30
+ export declare function prepareGeneratedDir(outputDir: string, targetDir: string, manifest: Iterable<string>, options?: PrepareOptions): Promise<PrepareResult>;
31
+ //# sourceMappingURL=prepare-output.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepare-output.d.ts","sourceRoot":"","sources":["../../src/lib/prepare-output.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA2BxB"}
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Clean-slate prepare for hermetic generated trees.
3
+ *
4
+ * `src/` is hermetic — every file there is emitted by the compiler and
5
+ * carries the "Generated by quickback.dev" header. The contract is "do
6
+ * not edit directly". So before each compile writes its output, the CLI
7
+ * archives the previous src/ tree (cheap recursive copy) and then wipes
8
+ * it. The fresh write recreates exactly the manifest the compiler
9
+ * produced — no orphan files, no stale folders left by removed features,
10
+ * no `.DS_Store` keeping a deleted feature folder alive, no dead
11
+ * SPA assets with old content hashes.
12
+ *
13
+ * The archive is the safety net: if a generator regression silently
14
+ * stopped emitting a file you depended on, the previous full tree is
15
+ * sitting in `quickback/.archives/src-<ISO>/` ready to grep or copy
16
+ * back. Old archives are pruned, keeping the most recent N.
17
+ *
18
+ * Sanity bound: if the manifest has zero files in the target dir, the
19
+ * wipe is skipped — that's almost always a compile bug upstream and
20
+ * we'd rather not lose the user's last-known-good output.
21
+ */
22
+ import { promises as fs } from 'fs';
23
+ import { join, sep } from 'path';
24
+ const DEFAULT_ARCHIVE_KEEP = 3;
25
+ /**
26
+ * Archive then wipe the target dir, in preparation for a fresh write.
27
+ *
28
+ * `manifest` is the full set of paths the compiler intends to write
29
+ * (relative to outputDir). It's used as a sanity check — if the
30
+ * manifest contains *no* files under targetDir we treat that as a
31
+ * compile bug and skip the destructive step.
32
+ *
33
+ * The wipe itself is a single fs.rm({recursive:true}) — fast, total,
34
+ * and matches the documented contract that src/ is compiler-owned.
35
+ */
36
+ export async function prepareGeneratedDir(outputDir, targetDir, manifest, options = {}) {
37
+ const fullTarget = join(outputDir, targetDir);
38
+ if (!(await pathExists(fullTarget))) {
39
+ return { wiped: false, skipped: 'no-existing-tree' };
40
+ }
41
+ const targetPrefix = normalizePath(targetDir).replace(/\/+$/, '') + '/';
42
+ let manifestHasTargetFiles = false;
43
+ for (const p of manifest) {
44
+ if (normalizePath(p).startsWith(targetPrefix)) {
45
+ manifestHasTargetFiles = true;
46
+ break;
47
+ }
48
+ }
49
+ if (!manifestHasTargetFiles) {
50
+ return { wiped: false, skipped: 'empty-manifest' };
51
+ }
52
+ let archivePath;
53
+ if (options.archiveDir) {
54
+ archivePath = await archiveDirectory(fullTarget, options.archiveDir, basename(targetDir));
55
+ await pruneArchives(options.archiveDir, basename(targetDir), options.archiveKeep ?? DEFAULT_ARCHIVE_KEEP);
56
+ }
57
+ await fs.rm(fullTarget, { recursive: true, force: true });
58
+ return { wiped: true, archivePath };
59
+ }
60
+ async function archiveDirectory(srcDir, archiveBase, prefix) {
61
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-').replace(/Z$/, '');
62
+ const dest = join(archiveBase, `${prefix}-${stamp}`);
63
+ await fs.mkdir(archiveBase, { recursive: true });
64
+ // fs.cp with recursive copies the tree, preserves dir structure, no deps.
65
+ await fs.cp(srcDir, dest, { recursive: true, force: true });
66
+ return dest;
67
+ }
68
+ async function pruneArchives(archiveBase, prefix, keep) {
69
+ if (!(await pathExists(archiveBase)))
70
+ return;
71
+ const entries = await fs.readdir(archiveBase);
72
+ const stamped = entries.filter((e) => e.startsWith(`${prefix}-`)).sort().reverse();
73
+ const stale = stamped.slice(keep);
74
+ for (const old of stale) {
75
+ await fs.rm(join(archiveBase, old), { recursive: true, force: true }).catch(() => { });
76
+ }
77
+ }
78
+ async function pathExists(p) {
79
+ try {
80
+ await fs.access(p);
81
+ return true;
82
+ }
83
+ catch {
84
+ return false;
85
+ }
86
+ }
87
+ function normalizePath(p) {
88
+ return sep === '/' ? p : p.split(sep).join('/');
89
+ }
90
+ function basename(p) {
91
+ const norm = normalizePath(p).replace(/\/+$/, '');
92
+ const idx = norm.lastIndexOf('/');
93
+ return idx >= 0 ? norm.slice(idx + 1) : norm;
94
+ }
95
+ //# sourceMappingURL=prepare-output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepare-output.js","sourceRoot":"","sources":["../../src/lib/prepare-output.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=prepare-output.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepare-output.test.d.ts","sourceRoot":"","sources":["../../src/lib/prepare-output.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,105 @@
1
+ import { describe, expect, test, beforeEach, afterEach } from 'bun:test';
2
+ import { promises as fs } from 'fs';
3
+ import { join } from 'path';
4
+ import { tmpdir } from 'os';
5
+ import { prepareGeneratedDir } from './prepare-output.js';
6
+ let tmp;
7
+ beforeEach(async () => {
8
+ tmp = await fs.mkdtemp(join(tmpdir(), 'prepare-gen-'));
9
+ });
10
+ afterEach(async () => {
11
+ await fs.rm(tmp, { recursive: true, force: true }).catch(() => { });
12
+ });
13
+ async function writeFile(rel, content = 'x') {
14
+ const full = join(tmp, ...rel.split('/'));
15
+ await fs.mkdir(join(full, '..'), { recursive: true });
16
+ await fs.writeFile(full, content);
17
+ }
18
+ async function fileExists(rel) {
19
+ try {
20
+ await fs.access(join(tmp, ...rel.split('/')));
21
+ return true;
22
+ }
23
+ catch {
24
+ return false;
25
+ }
26
+ }
27
+ describe('prepareGeneratedDir — clean-slate compile output prep', () => {
28
+ // User story: As a developer renaming a feature, I want the old feature
29
+ // folder gone after compile — clean slate means no ghost dirs, no stale
30
+ // .DS_Store files keeping deleted folders alive in the tree.
31
+ test('wipes the existing target dir entirely (folders included)', async () => {
32
+ await writeFile('src/features/old/schema.ts');
33
+ await writeFile('src/features/old/.DS_Store');
34
+ await writeFile('src/features/new/schema.ts');
35
+ const result = await prepareGeneratedDir(tmp, 'src', ['src/features/new/schema.ts']);
36
+ expect(result.wiped).toBe(true);
37
+ expect(await fileExists('src')).toBe(false);
38
+ expect(await fileExists('src/features/old/.DS_Store')).toBe(false);
39
+ });
40
+ // User story: As a developer running compile for the first time, I want
41
+ // the helper to be a no-op — there's nothing to wipe yet.
42
+ test('skips wipe when target dir does not exist', async () => {
43
+ const result = await prepareGeneratedDir(tmp, 'src', ['src/index.ts']);
44
+ expect(result.wiped).toBe(false);
45
+ expect(result.skipped).toBe('no-existing-tree');
46
+ });
47
+ // User story: As a developer protected from compiler bugs, I want the
48
+ // wipe to refuse to run when the compiler returned an empty manifest —
49
+ // that's almost always a regression, and I'd rather keep my last
50
+ // known-good output than lose it to a misfire.
51
+ test('refuses to wipe when manifest has no files in the target dir', async () => {
52
+ await writeFile('src/features/x/schema.ts');
53
+ const result = await prepareGeneratedDir(tmp, 'src', ['package.json', 'wrangler.toml']);
54
+ expect(result.wiped).toBe(false);
55
+ expect(result.skipped).toBe('empty-manifest');
56
+ expect(await fileExists('src/features/x/schema.ts')).toBe(true);
57
+ });
58
+ // User story: As a developer about to lose 60 generator-emitted files in
59
+ // a wipe, I want a snapshot of src/ saved automatically so I can recover
60
+ // if the compiler stopped emitting something I was depending on.
61
+ test('archives the existing tree before wiping', async () => {
62
+ await writeFile('src/features/old/schema.ts', 'PRE-WIPE CONTENT');
63
+ await writeFile('src/lib/auth.ts');
64
+ const archiveDir = join(tmp, 'quickback', '.archives');
65
+ const result = await prepareGeneratedDir(tmp, 'src', ['src/lib/auth.ts'], { archiveDir });
66
+ expect(result.wiped).toBe(true);
67
+ expect(result.archivePath).toBeDefined();
68
+ const archived = await fs.readdir(result.archivePath, { recursive: true });
69
+ expect(archived).toContain(join('features', 'old', 'schema.ts'));
70
+ expect(archived).toContain(join('lib', 'auth.ts'));
71
+ const recovered = await fs.readFile(join(result.archivePath, 'features', 'old', 'schema.ts'), 'utf-8');
72
+ expect(recovered).toBe('PRE-WIPE CONTENT');
73
+ });
74
+ // User story: As a developer who refactors aggressively, I want older
75
+ // snapshots pruned automatically so .archives/ doesn't balloon — keeping
76
+ // the most recent 3 is enough to walk back from a regret.
77
+ test('prunes archives beyond archiveKeep, newest-first', async () => {
78
+ const archiveDir = join(tmp, 'archives');
79
+ await fs.mkdir(archiveDir, { recursive: true });
80
+ for (const stamp of ['src-0001', 'src-0002', 'src-0003', 'src-0004']) {
81
+ await fs.mkdir(join(archiveDir, stamp));
82
+ }
83
+ await writeFile('src/index.ts');
84
+ await prepareGeneratedDir(tmp, 'src', ['src/index.ts'], {
85
+ archiveDir,
86
+ archiveKeep: 3,
87
+ });
88
+ const remaining = (await fs.readdir(archiveDir)).filter((d) => d.startsWith('src-'));
89
+ expect(remaining.length).toBe(3);
90
+ // Newest survives — pruning is alphabetical-descending.
91
+ expect(remaining).toContain('src-0004');
92
+ expect(remaining).not.toContain('src-0001');
93
+ });
94
+ // User story: As a developer running quickback compile back-to-back with
95
+ // the archive turned on, I want to see consistent timestamps on the
96
+ // archive directory so I can identify which snapshot came from which
97
+ // compile if I need to recover.
98
+ test('archive directory name includes a sortable ISO timestamp', async () => {
99
+ await writeFile('src/index.ts');
100
+ const archiveDir = join(tmp, 'archives');
101
+ const result = await prepareGeneratedDir(tmp, 'src', ['src/index.ts'], { archiveDir });
102
+ expect(result.archivePath).toMatch(/src-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}/);
103
+ });
104
+ });
105
+ //# sourceMappingURL=prepare-output.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepare-output.test.js","sourceRoot":"","sources":["../../src/lib/prepare-output.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ export interface SweepOptions {
2
+ /**
3
+ * If set, copy the target dir into `<archiveDir>/<targetBasename>-<ISO>/`
4
+ * before deleting anything. No-op when no orphans are found.
5
+ */
6
+ archiveDir?: string;
7
+ /** How many archives to retain. Defaults to 3. */
8
+ archiveKeep?: number;
9
+ /** Subtrees (relative to outputDir) to skip — e.g. SPA asset dirs that already get a hard wipe upstream. */
10
+ skipPrefixes?: Iterable<string>;
11
+ }
12
+ export interface SweepResult {
13
+ /** Files deleted because they were stale orphans. */
14
+ deleted: string[];
15
+ /** Files NOT deleted despite being missing from the manifest — they lacked the generated-header marker. */
16
+ preserved: string[];
17
+ /** Path to the archive created before deletion (undefined when nothing was deleted or archiveDir wasn't set). */
18
+ archivePath?: string;
19
+ }
20
+ /**
21
+ * Sweep stale generated files under `targetDir`. Paths in `manifest` are
22
+ * relative to `outputDir` (matching the wire shape the compiler returns).
23
+ */
24
+ export declare function sweepStaleGeneratedFiles(outputDir: string, targetDir: string, manifest: Iterable<string>, options?: SweepOptions): Promise<SweepResult>;
25
+ //# sourceMappingURL=sweep-stale.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sweep-stale.d.ts","sourceRoot":"","sources":["../../src/lib/sweep-stale.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2GAA2G;IAC3G,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iHAAiH;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC1B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA8CtB"}
@@ -0,0 +1,179 @@
1
+ /**
2
+ * Stale-file sweep for generated output trees.
3
+ *
4
+ * `src/` is hermetic — every file there is emitted by the compiler and
5
+ * carries the "Generated by quickback.dev" header. When a feature is
6
+ * removed/renamed or a generator stops emitting a file, the orphaned file
7
+ * lingers under merge-only writes and can mask bugs (dead routes, ghost
8
+ * imports, mismatched types, stale schemas the user assumes are current).
9
+ *
10
+ * This helper walks a target dir, deletes any file whose path isn't in the
11
+ * compiler's manifest *and* carries the generated-header marker, then
12
+ * collapses the empty directories left behind. Files without the marker are
13
+ * preserved (defence against accidentally nuking hand-authored content that
14
+ * snuck into a generated tree).
15
+ *
16
+ * Before any deletes, it copies the target dir into a timestamped archive
17
+ * under `archiveDir` (when provided). The archive is uncompressed (just a
18
+ * recursive copy via Node's built-in fs.cp) so it's trivially inspectable
19
+ * and recoverable with `cp -r`. Old archives beyond `archiveKeep` are
20
+ * pruned. The archive is skipped entirely on no-op compiles where no
21
+ * orphans were found.
22
+ */
23
+ import { promises as fs } from 'fs';
24
+ import { join, relative, sep } from 'path';
25
+ const GENERATED_MARKER = 'Generated by quickback.dev';
26
+ const HEADER_PROBE_BYTES = 512;
27
+ const DEFAULT_ARCHIVE_KEEP = 3;
28
+ /**
29
+ * OS / editor noise that every contributor accidentally drops into checked-out
30
+ * trees. These files are *never* compiler output and *never* user-authored
31
+ * content the user cares about — silently skip them rather than warning the
32
+ * user every compile that ".DS_Store has no Quickback header".
33
+ */
34
+ const SILENT_IGNORE_BASENAMES = new Set([
35
+ '.DS_Store',
36
+ 'Thumbs.db',
37
+ '.localized',
38
+ ]);
39
+ /**
40
+ * Sweep stale generated files under `targetDir`. Paths in `manifest` are
41
+ * relative to `outputDir` (matching the wire shape the compiler returns).
42
+ */
43
+ export async function sweepStaleGeneratedFiles(outputDir, targetDir, manifest, options = {}) {
44
+ const result = { deleted: [], preserved: [] };
45
+ const fullTarget = join(outputDir, targetDir);
46
+ if (!(await pathExists(fullTarget)))
47
+ return result;
48
+ const manifestSet = new Set();
49
+ for (const p of manifest)
50
+ manifestSet.add(normalizePath(p));
51
+ const skipNormalized = [...(options.skipPrefixes ?? [])].map(normalizePath);
52
+ const isSkipped = (relPath) => skipNormalized.some((sp) => relPath === sp || relPath.startsWith(sp + '/'));
53
+ const onDisk = [];
54
+ await collectFiles(fullTarget, outputDir, onDisk);
55
+ // First pass: identify deletions without acting, so the archive captures
56
+ // the pre-delete state and runs only when there's something to lose.
57
+ const toDelete = [];
58
+ for (const relPath of onDisk) {
59
+ if (manifestSet.has(relPath))
60
+ continue;
61
+ if (isSkipped(relPath))
62
+ continue;
63
+ const base = relPath.slice(relPath.lastIndexOf('/') + 1);
64
+ if (SILENT_IGNORE_BASENAMES.has(base))
65
+ continue;
66
+ const fullPath = join(outputDir, relPath);
67
+ if (await fileHasMarker(fullPath, GENERATED_MARKER)) {
68
+ toDelete.push(relPath);
69
+ }
70
+ else {
71
+ result.preserved.push(relPath);
72
+ }
73
+ }
74
+ if (toDelete.length === 0)
75
+ return result;
76
+ if (options.archiveDir) {
77
+ result.archivePath = await archiveDirectory(fullTarget, options.archiveDir, basename(targetDir));
78
+ await pruneArchives(options.archiveDir, basename(targetDir), options.archiveKeep ?? DEFAULT_ARCHIVE_KEEP);
79
+ }
80
+ for (const relPath of toDelete) {
81
+ await fs.unlink(join(outputDir, relPath));
82
+ result.deleted.push(relPath);
83
+ }
84
+ await removeEmptyDirs(fullTarget);
85
+ return result;
86
+ }
87
+ async function archiveDirectory(srcDir, archiveBase, prefix) {
88
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-').replace(/Z$/, '');
89
+ const dest = join(archiveBase, `${prefix}-${stamp}`);
90
+ await fs.mkdir(archiveBase, { recursive: true });
91
+ // fs.cp with recursive copies the tree, preserves dir structure, no deps.
92
+ await fs.cp(srcDir, dest, { recursive: true, force: true });
93
+ return dest;
94
+ }
95
+ async function pruneArchives(archiveBase, prefix, keep) {
96
+ if (!(await pathExists(archiveBase)))
97
+ return;
98
+ const entries = await fs.readdir(archiveBase);
99
+ const stamped = entries.filter((e) => e.startsWith(`${prefix}-`)).sort().reverse();
100
+ const stale = stamped.slice(keep);
101
+ for (const old of stale) {
102
+ await fs.rm(join(archiveBase, old), { recursive: true, force: true }).catch(() => { });
103
+ }
104
+ }
105
+ async function pathExists(p) {
106
+ try {
107
+ await fs.access(p);
108
+ return true;
109
+ }
110
+ catch {
111
+ return false;
112
+ }
113
+ }
114
+ async function collectFiles(dir, outputDir, into) {
115
+ let entries;
116
+ try {
117
+ entries = await fs.readdir(dir, { withFileTypes: true });
118
+ }
119
+ catch {
120
+ return;
121
+ }
122
+ for (const entry of entries) {
123
+ const full = join(dir, entry.name);
124
+ if (entry.isDirectory()) {
125
+ await collectFiles(full, outputDir, into);
126
+ }
127
+ else if (entry.isFile()) {
128
+ into.push(normalizePath(relative(outputDir, full)));
129
+ }
130
+ }
131
+ }
132
+ async function fileHasMarker(path, marker) {
133
+ let handle = null;
134
+ try {
135
+ handle = await fs.open(path, 'r');
136
+ const buf = Buffer.alloc(HEADER_PROBE_BYTES);
137
+ const { bytesRead } = await handle.read(buf, 0, HEADER_PROBE_BYTES, 0);
138
+ return buf.subarray(0, bytesRead).toString('utf8').includes(marker);
139
+ }
140
+ catch {
141
+ return false;
142
+ }
143
+ finally {
144
+ if (handle)
145
+ await handle.close();
146
+ }
147
+ }
148
+ async function removeEmptyDirs(dir) {
149
+ let entries;
150
+ try {
151
+ entries = await fs.readdir(dir, { withFileTypes: true });
152
+ }
153
+ catch {
154
+ return;
155
+ }
156
+ for (const entry of entries) {
157
+ if (entry.isDirectory()) {
158
+ await removeEmptyDirs(join(dir, entry.name));
159
+ }
160
+ }
161
+ try {
162
+ const after = await fs.readdir(dir);
163
+ if (after.length === 0) {
164
+ await fs.rmdir(dir).catch(() => { });
165
+ }
166
+ }
167
+ catch {
168
+ /* ignore */
169
+ }
170
+ }
171
+ function normalizePath(p) {
172
+ return sep === '/' ? p : p.split(sep).join('/');
173
+ }
174
+ function basename(p) {
175
+ const norm = normalizePath(p).replace(/\/+$/, '');
176
+ const idx = norm.lastIndexOf('/');
177
+ return idx >= 0 ? norm.slice(idx + 1) : norm;
178
+ }
179
+ //# sourceMappingURL=sweep-stale.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sweep-stale.js","sourceRoot":"","sources":["../../src/lib/sweep-stale.ts"],"names":[],"mappings":"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"}