@adhdev/mesh-shared 0.9.82-rc.428 → 0.9.82-rc.429

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 (3) hide show
  1. package/dist/magi.d.ts +29 -0
  2. package/package.json +1 -1
  3. package/src/magi.ts +31 -0
package/dist/magi.d.ts CHANGED
@@ -29,6 +29,25 @@ export interface MagiPanelMember {
29
29
  /** Optional per-member replica count; defaults to the panel.defaultN / global n / 1. */
30
30
  n?: number;
31
31
  }
32
+ /**
33
+ * The output-schema selector a MAGI fan-out injects into every replica prompt and
34
+ * the strict parser used at collection. Code-orthogonal to the panel's member set
35
+ * (the fan-out planner never reads it) — it ONLY shapes the per-replica prompt /
36
+ * parse contract. SSOT lives here (mesh-shared leaf) so both daemon-core (panel
37
+ * normalization) and mcp-server (resolution / prompt assembly) consume one union.
38
+ *
39
+ * - claim_audit (default, backward-compatible), rca, design → require evidence[].
40
+ * - freeform → no schema, no evidence; contributes NO structured claims to
41
+ * synthesis, so it is NOT a valid panel `defaultKind` (a panel is a
42
+ * cross-verification tool; a default that zeroes out cross-verification is
43
+ * self-contradictory). Normalization drops/rejects defaultKind === 'freeform'.
44
+ */
45
+ export type MagiTaskKind = 'claim_audit' | 'rca' | 'design' | 'freeform';
46
+ /**
47
+ * The kinds valid as a panel `defaultKind` — every MagiTaskKind EXCEPT 'freeform'
48
+ * (which contributes no structured claims, so it must not be a panel-level default).
49
+ */
50
+ export type MagiPanelDefaultKind = Exclude<MagiTaskKind, 'freeform'>;
32
51
  /**
33
52
  * A named MAGI panel. Stored machine-local in `~/.adhdev/meshes.json` under the
34
53
  * top-level `magiPanels` map (sibling to `meshes`), because a member binds
@@ -42,6 +61,16 @@ export interface MagiPanel {
42
61
  defaultN?: number;
43
62
  /** Marks the panel's fan-out as intentional same-prompt duplication (always true in practice). */
44
63
  dedupExempt?: boolean;
64
+ /**
65
+ * Optional, NON-binding default output kind for fan-outs invoked through this
66
+ * panel. NOT a first-class panel axis (task_kind is code-orthogonal to the
67
+ * member set) — just a fallback applied when a review omits an explicit
68
+ * task_kind. Resolution priority is strictly
69
+ * `args.task_kind > panel.defaultKind > 'claim_audit'`, so it never changes the
70
+ * schema of an automation that already passes task_kind. 'freeform' is rejected
71
+ * at normalization (see MagiPanelDefaultKind).
72
+ */
73
+ defaultKind?: MagiPanelDefaultKind;
45
74
  }
46
75
  /** Top-level `magiPanels` map in meshes.json, keyed by panel name. */
47
76
  export type MagiPanelMap = Record<string, MagiPanel>;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adhdev/mesh-shared",
3
- "version": "0.9.82-rc.428",
3
+ "version": "0.9.82-rc.429",
4
4
  "description": "ADHDev mesh-shared — pure mesh/git status normalizers shared by daemon-core and web-core",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
package/src/magi.ts CHANGED
@@ -33,6 +33,27 @@ export interface MagiPanelMember {
33
33
  n?: number
34
34
  }
35
35
 
36
+ /**
37
+ * The output-schema selector a MAGI fan-out injects into every replica prompt and
38
+ * the strict parser used at collection. Code-orthogonal to the panel's member set
39
+ * (the fan-out planner never reads it) — it ONLY shapes the per-replica prompt /
40
+ * parse contract. SSOT lives here (mesh-shared leaf) so both daemon-core (panel
41
+ * normalization) and mcp-server (resolution / prompt assembly) consume one union.
42
+ *
43
+ * - claim_audit (default, backward-compatible), rca, design → require evidence[].
44
+ * - freeform → no schema, no evidence; contributes NO structured claims to
45
+ * synthesis, so it is NOT a valid panel `defaultKind` (a panel is a
46
+ * cross-verification tool; a default that zeroes out cross-verification is
47
+ * self-contradictory). Normalization drops/rejects defaultKind === 'freeform'.
48
+ */
49
+ export type MagiTaskKind = 'claim_audit' | 'rca' | 'design' | 'freeform'
50
+
51
+ /**
52
+ * The kinds valid as a panel `defaultKind` — every MagiTaskKind EXCEPT 'freeform'
53
+ * (which contributes no structured claims, so it must not be a panel-level default).
54
+ */
55
+ export type MagiPanelDefaultKind = Exclude<MagiTaskKind, 'freeform'>
56
+
36
57
  /**
37
58
  * A named MAGI panel. Stored machine-local in `~/.adhdev/meshes.json` under the
38
59
  * top-level `magiPanels` map (sibling to `meshes`), because a member binds
@@ -46,6 +67,16 @@ export interface MagiPanel {
46
67
  defaultN?: number
47
68
  /** Marks the panel's fan-out as intentional same-prompt duplication (always true in practice). */
48
69
  dedupExempt?: boolean
70
+ /**
71
+ * Optional, NON-binding default output kind for fan-outs invoked through this
72
+ * panel. NOT a first-class panel axis (task_kind is code-orthogonal to the
73
+ * member set) — just a fallback applied when a review omits an explicit
74
+ * task_kind. Resolution priority is strictly
75
+ * `args.task_kind > panel.defaultKind > 'claim_audit'`, so it never changes the
76
+ * schema of an automation that already passes task_kind. 'freeform' is rejected
77
+ * at normalization (see MagiPanelDefaultKind).
78
+ */
79
+ defaultKind?: MagiPanelDefaultKind
49
80
  }
50
81
 
51
82
  /** Top-level `magiPanels` map in meshes.json, keyed by panel name. */