@quickback-dev/cli 0.47.12 → 0.47.13

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 (37) hide show
  1. package/dist/docs/content.js +4 -4
  2. package/dist/docs/content.js.map +1 -1
  3. package/dist/index.js +1 -1
  4. package/dist/lib/action-harvest.d.ts.map +1 -1
  5. package/dist/lib/action-harvest.js +110 -46
  6. package/dist/lib/action-harvest.js.map +1 -1
  7. package/dist/lib/action-harvest.test.js +97 -0
  8. package/dist/lib/action-harvest.test.js.map +1 -1
  9. package/dist/lib/api-client.d.ts.map +1 -1
  10. package/dist/lib/api-client.js +18 -1
  11. package/dist/lib/api-client.js.map +1 -1
  12. package/dist/skill/docs/changelog.md +51 -0
  13. package/dist/skill/docs/compiler/config/agents.md +1 -1
  14. package/dist/skill/docs/compiler/definitions/scopes.md +140 -2
  15. package/dist/skill/docs/stack/schedules/index.md +17 -0
  16. package/package.json +1 -1
  17. package/src/skill/docs/changelog.md +51 -0
  18. package/src/skill/docs/compiler/config/agents.md +1 -1
  19. package/src/skill/docs/compiler/definitions/scopes.md +140 -2
  20. package/src/skill/docs/stack/schedules/index.md +17 -0
  21. package/dist/codex/AGENTS.md +0 -290
  22. package/dist/commands/codex.d.ts +0 -16
  23. package/dist/commands/codex.d.ts.map +0 -1
  24. package/dist/commands/codex.js +0 -159
  25. package/dist/commands/codex.js.map +0 -1
  26. package/dist/commands/init.d.ts +0 -6
  27. package/dist/commands/init.d.ts.map +0 -1
  28. package/dist/commands/init.js +0 -405
  29. package/dist/commands/init.js.map +0 -1
  30. package/dist/lib/sweep-stale.d.ts +0 -25
  31. package/dist/lib/sweep-stale.d.ts.map +0 -1
  32. package/dist/lib/sweep-stale.js +0 -179
  33. package/dist/lib/sweep-stale.js.map +0 -1
  34. package/dist/lib/sweep-stale.test.d.ts +0 -2
  35. package/dist/lib/sweep-stale.test.d.ts.map +0 -1
  36. package/dist/lib/sweep-stale.test.js +0 -130
  37. package/dist/lib/sweep-stale.test.js.map +0 -1
@@ -1,130 +0,0 @@
1
- import { describe, expect, test, beforeEach, afterEach } from 'bun:test';
2
- import { promises as fs } from 'fs';
3
- import { join, sep } from 'path';
4
- import { tmpdir } from 'os';
5
- import { sweepStaleGeneratedFiles } from './sweep-stale.js';
6
- const HEADER = '/**\n * Generated by quickback.dev\n */\n';
7
- const PLAIN = '// hand-authored content\n';
8
- let tmp;
9
- beforeEach(async () => {
10
- tmp = await fs.mkdtemp(join(tmpdir(), 'sweep-stale-'));
11
- });
12
- afterEach(async () => {
13
- await fs.rm(tmp, { recursive: true, force: true }).catch(() => { });
14
- });
15
- async function writeFile(rel, content) {
16
- const full = join(tmp, ...rel.split('/'));
17
- await fs.mkdir(join(full, '..'), { recursive: true });
18
- await fs.writeFile(full, content);
19
- }
20
- async function fileExists(rel) {
21
- try {
22
- await fs.access(join(tmp, ...rel.split('/')));
23
- return true;
24
- }
25
- catch {
26
- return false;
27
- }
28
- }
29
- describe('sweepStaleGeneratedFiles', () => {
30
- // User story: As a developer who renames a feature, I want stale generator
31
- // output from the old name to disappear so my project tree reflects only
32
- // what the current config produces — no ghost routes/types lingering.
33
- test('deletes generated files not in the manifest', async () => {
34
- await writeFile('src/features/old/schema.ts', HEADER);
35
- await writeFile('src/features/new/schema.ts', HEADER);
36
- const result = await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts']);
37
- expect(result.deleted.sort()).toEqual(['src/features/old/schema.ts']);
38
- expect(await fileExists('src/features/old/schema.ts')).toBe(false);
39
- expect(await fileExists('src/features/new/schema.ts')).toBe(true);
40
- });
41
- // User story: As a developer who pasted a personal note into src/, I want
42
- // the sweep to leave my hand-authored file alone — the header check is the
43
- // line between "compiler owns this" and "the user owns this".
44
- test('preserves files without the generated-header marker', async () => {
45
- await writeFile('src/features/new/notes.md', PLAIN);
46
- await writeFile('src/features/new/schema.ts', HEADER);
47
- const result = await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts']);
48
- expect(result.deleted).toEqual([]);
49
- expect(result.preserved).toEqual(['src/features/new/notes.md']);
50
- expect(await fileExists('src/features/new/notes.md')).toBe(true);
51
- });
52
- // User story: As a developer running quickback compile back-to-back with no
53
- // changes, I want the sweep to be a fast no-op — no spurious archive dirs
54
- // littering the repo every time I recompile.
55
- test('does not archive when nothing is stale', async () => {
56
- await writeFile('src/features/new/schema.ts', HEADER);
57
- const archiveDir = join(tmp, 'quickback', '.archives');
58
- const result = await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts'], {
59
- archiveDir,
60
- });
61
- expect(result.deleted).toEqual([]);
62
- expect(result.archivePath).toBeUndefined();
63
- expect(await fileExists('quickback/.archives')).toBe(false);
64
- });
65
- // User story: As a developer about to lose 30 generator-emitted files in a
66
- // sweep, I want a snapshot of src/ saved automatically so I can recover if
67
- // the compiler stopped emitting something I was depending on.
68
- test('archives src/ before deleting when orphans are present', async () => {
69
- await writeFile('src/features/old/schema.ts', HEADER);
70
- await writeFile('src/features/new/schema.ts', HEADER);
71
- const archiveDir = join(tmp, 'quickback', '.archives');
72
- const result = await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts'], {
73
- archiveDir,
74
- });
75
- expect(result.deleted).toEqual(['src/features/old/schema.ts']);
76
- expect(result.archivePath).toBeDefined();
77
- // Archive should contain a copy of the pre-sweep tree.
78
- const archived = await fs.readdir(result.archivePath, { recursive: true });
79
- const flat = archived.map((p) => (sep === '/' ? p : p.split(sep).join('/')));
80
- expect(flat).toContain('features/old/schema.ts');
81
- expect(flat).toContain('features/new/schema.ts');
82
- });
83
- // User story: As a developer who refactors aggressively over a week, I want
84
- // older snapshots pruned automatically so the .archives folder doesn't
85
- // balloon — last 3 generations is enough to walk back from a regret.
86
- test('prunes old archives, keeping most recent N', async () => {
87
- const archiveDir = join(tmp, 'archives');
88
- await fs.mkdir(archiveDir, { recursive: true });
89
- // Pre-seed 5 fake archives with sortable names.
90
- for (const stamp of ['src-0001', 'src-0002', 'src-0003', 'src-0004']) {
91
- await fs.mkdir(join(archiveDir, stamp));
92
- }
93
- await writeFile('src/features/old/schema.ts', HEADER);
94
- await writeFile('src/features/new/schema.ts', HEADER);
95
- await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts'], {
96
- archiveDir,
97
- archiveKeep: 3,
98
- });
99
- const remaining = (await fs.readdir(archiveDir)).filter((d) => d.startsWith('src-'));
100
- expect(remaining.length).toBe(3);
101
- // Newest survives — pruning is alphabetical-descending.
102
- expect(remaining).toContain('src-0004');
103
- expect(remaining).not.toContain('src-0001');
104
- });
105
- // User story: As a developer with SPA bundles in src/apps/cms/assets/, I want
106
- // the sweep to leave that subtree alone — the upstream code wipes it
107
- // wholesale before each write, so the per-file header probe would be
108
- // wasted work.
109
- test('respects skipPrefixes (SPA asset dirs)', async () => {
110
- await writeFile('src/apps/cms/assets/main-abc123.js', HEADER);
111
- await writeFile('src/apps/cms/assets/main-def456.js', HEADER);
112
- const result = await sweepStaleGeneratedFiles(tmp, 'src', ['src/apps/cms/assets/main-def456.js'], {
113
- skipPrefixes: ['src/apps/cms/assets'],
114
- });
115
- expect(result.deleted).toEqual([]);
116
- expect(await fileExists('src/apps/cms/assets/main-abc123.js')).toBe(true);
117
- });
118
- // User story: As a developer with a now-empty src/features/old/ after a
119
- // sweep, I don't want the bare directory hanging around — the file tree
120
- // should match the manifest, including its shape.
121
- test('removes empty directories left after deletion', async () => {
122
- await writeFile('src/features/old/schema.ts', HEADER);
123
- await writeFile('src/features/old/routes.ts', HEADER);
124
- await writeFile('src/features/new/schema.ts', HEADER);
125
- await sweepStaleGeneratedFiles(tmp, 'src', ['src/features/new/schema.ts']);
126
- expect(await fileExists('src/features/old')).toBe(false);
127
- expect(await fileExists('src/features/new')).toBe(true);
128
- });
129
- });
130
- //# sourceMappingURL=sweep-stale.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sweep-stale.test.js","sourceRoot":"","sources":["../../src/lib/sweep-stale.test.ts"],"names":[],"mappings":"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"}