@venizia/vulcan 0.4.9-5 → 0.4.9-6

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.
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The automatic clean of `.agents/local/`, started detached by the session-start hook at most once a day
3
+ * (src/local/auto-clean.ts). It removes the safe part only (src/local/auto-clean-run.ts) and writes a stamp with what went.
4
+ * It fails open: nothing waits for it, and an error is a line on a stderr nobody reads.
5
+ */
6
+
7
+ // A module, so the awaits below are top-level; it has no static import, by design.
8
+ export {};
9
+
10
+ try {
11
+ const root = process.argv[2];
12
+
13
+ if (root !== undefined && root !== '') {
14
+ const { AutoCleanRun } = await import('../../src/local/auto-clean-run.ts');
15
+
16
+ AutoCleanRun.run({ root });
17
+ }
18
+ } catch (error) {
19
+ console.error(
20
+ `vulcan: the automatic clean failed (${error instanceof Error ? error.message : String(error)})`,
21
+ );
22
+ }
@@ -19,3 +19,15 @@ try {
19
19
  `vulcan: [session-start] could not make TMPDIR the project's temp folder: ${error}`,
20
20
  );
21
21
  }
22
+
23
+ // At most once a day, the safe part of .agents/local/ is cleaned by a process of its own: the session does not wait for it.
24
+ try {
25
+ const { LocalAutoClean } = await import('../../src/local/auto-clean.ts');
26
+ const note = LocalAutoClean.tick({ root: projectRoot });
27
+
28
+ if (note !== undefined) {
29
+ console.error(note);
30
+ }
31
+ } catch (error) {
32
+ console.error(`vulcan: [session-start] the automatic clean was skipped: ${error}`);
33
+ }
@@ -48,7 +48,7 @@ Classify before proposing anything, in this order:
48
48
  | Rule | A judgement call no program can make | One line in the rules, through the admission bar below |
49
49
  | Skill edit | The skill led the agent wrong, or left a step out | The smallest edit to the skill, and its eval |
50
50
  | Knowledge fact | The agent lacked a fact the project could state | A line in the knowledge bundle (`knowledge-sync` skill) |
51
- | Out of scope | The proposal was considered and rejected | One file in `.agents/out-of-scope/`: the reasons, the date, what would reopen it |
51
+ | Rejected | The proposal was considered and rejected | A note in the issue or pull request where it was rejected: the reasons, the date, what would reopen it |
52
52
  | Nothing | A rule already exists and was loaded; the lapse was one-off | Say so: "nothing, the rule exists" |
53
53
 
54
54
  The admission bar for a rule or a skill line: an observed failure with a date; a mechanical violation
@@ -64,6 +64,6 @@ change installed without a pick is how good work gets blocked. Ask once, with a
64
64
  ## 5. Apply what was picked
65
65
 
66
66
  Only the owner's picks, each through its own path: a check through `build-a-feature`, a rule or skill line
67
- through the admission bar, a knowledge fact through `knowledge-sync`, a rejection as an out-of-scope file.
67
+ through the admission bar, a knowledge fact through `knowledge-sync`, a rejection as a note in the issue or pull request where it was rejected.
68
68
  Open an issue only for a pick. Report with `report-back`: what was applied, what was left, and the state of
69
69
  the previous retro's items.