pi-daddy 0.49.4 → 0.50.0

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 (149) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +218 -28
  3. package/dist/governance/initiative-coordinator.d.ts +58 -0
  4. package/dist/governance/initiative-coordinator.d.ts.map +1 -0
  5. package/dist/governance/initiative-coordinator.js +348 -0
  6. package/dist/governance/initiative-coordinator.js.map +1 -0
  7. package/dist/governance/initiative-effects.d.ts +20 -0
  8. package/dist/governance/initiative-effects.d.ts.map +1 -0
  9. package/dist/governance/initiative-effects.js +108 -0
  10. package/dist/governance/initiative-effects.js.map +1 -0
  11. package/dist/governance/initiative-state.d.ts +13 -0
  12. package/dist/governance/initiative-state.d.ts.map +1 -0
  13. package/dist/governance/initiative-state.js +122 -0
  14. package/dist/governance/initiative-state.js.map +1 -0
  15. package/dist/governance/operation-artifact-io.d.ts +8 -0
  16. package/dist/governance/operation-artifact-io.d.ts.map +1 -0
  17. package/dist/governance/operation-artifact-io.js +95 -0
  18. package/dist/governance/operation-artifact-io.js.map +1 -0
  19. package/dist/governance/operation-artifact-scan.d.ts +13 -0
  20. package/dist/governance/operation-artifact-scan.d.ts.map +1 -0
  21. package/dist/governance/operation-artifact-scan.js +71 -0
  22. package/dist/governance/operation-artifact-scan.js.map +1 -0
  23. package/dist/governance/operation-artifacts.d.ts +53 -0
  24. package/dist/governance/operation-artifacts.d.ts.map +1 -0
  25. package/dist/governance/operation-artifacts.js +309 -0
  26. package/dist/governance/operation-artifacts.js.map +1 -0
  27. package/dist/governance/runtime-settlement.d.ts +2 -0
  28. package/dist/governance/runtime-settlement.d.ts.map +1 -1
  29. package/dist/governance/runtime-settlement.js +26 -0
  30. package/dist/governance/runtime-settlement.js.map +1 -1
  31. package/dist/governance/workspace-acceptance.d.ts +5 -0
  32. package/dist/governance/workspace-acceptance.d.ts.map +1 -1
  33. package/dist/governance/workspace-acceptance.js +16 -0
  34. package/dist/governance/workspace-acceptance.js.map +1 -1
  35. package/dist/index.d.ts +8 -0
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +8 -0
  38. package/dist/index.js.map +1 -1
  39. package/dist/kernel/dashboard-observation.d.ts +76 -0
  40. package/dist/kernel/dashboard-observation.d.ts.map +1 -0
  41. package/dist/kernel/dashboard-observation.js +49 -0
  42. package/dist/kernel/dashboard-observation.js.map +1 -0
  43. package/dist/kernel/dispatch-operation.d.ts +2 -0
  44. package/dist/kernel/dispatch-operation.d.ts.map +1 -1
  45. package/dist/kernel/dispatch-operation.js.map +1 -1
  46. package/dist/kernel/initiative.d.ts +94 -0
  47. package/dist/kernel/initiative.d.ts.map +1 -0
  48. package/dist/kernel/initiative.js +38 -0
  49. package/dist/kernel/initiative.js.map +1 -0
  50. package/dist/kernel/operation-artifact.d.ts +49 -0
  51. package/dist/kernel/operation-artifact.d.ts.map +1 -0
  52. package/dist/kernel/operation-artifact.js +4 -0
  53. package/dist/kernel/operation-artifact.js.map +1 -0
  54. package/dist/kernel/principal-binding.d.ts +4 -0
  55. package/dist/kernel/principal-binding.d.ts.map +1 -0
  56. package/dist/kernel/principal-binding.js +94 -0
  57. package/dist/kernel/principal-binding.js.map +1 -0
  58. package/dist/kernel/project-paths.d.ts +6 -0
  59. package/dist/kernel/project-paths.d.ts.map +1 -1
  60. package/dist/kernel/project-paths.js +12 -0
  61. package/dist/kernel/project-paths.js.map +1 -1
  62. package/dist/kernel/selected-definitions.d.ts.map +1 -1
  63. package/dist/kernel/selected-definitions.js +5 -91
  64. package/dist/kernel/selected-definitions.js.map +1 -1
  65. package/dist/kernel/workspace-diagnostics.d.ts +24 -0
  66. package/dist/kernel/workspace-diagnostics.d.ts.map +1 -0
  67. package/dist/kernel/workspace-diagnostics.js +81 -0
  68. package/dist/kernel/workspace-diagnostics.js.map +1 -0
  69. package/dist/products/activity-storage.d.ts +2 -0
  70. package/dist/products/activity-storage.d.ts.map +1 -0
  71. package/dist/products/activity-storage.js +119 -0
  72. package/dist/products/activity-storage.js.map +1 -0
  73. package/dist/products/activity-timeline.d.ts +4 -0
  74. package/dist/products/activity-timeline.d.ts.map +1 -1
  75. package/dist/products/activity-timeline.js +12 -0
  76. package/dist/products/activity-timeline.js.map +1 -1
  77. package/dist/products/dashboard-cli.d.ts +2 -0
  78. package/dist/products/dashboard-cli.d.ts.map +1 -1
  79. package/dist/products/dashboard-cli.js +41 -9
  80. package/dist/products/dashboard-cli.js.map +1 -1
  81. package/dist/products/dashboard-display-controls.d.ts.map +1 -1
  82. package/dist/products/dashboard-display-controls.js +30 -0
  83. package/dist/products/dashboard-display-controls.js.map +1 -1
  84. package/dist/products/dashboard-file-cache.d.ts +10 -0
  85. package/dist/products/dashboard-file-cache.d.ts.map +1 -0
  86. package/dist/products/dashboard-file-cache.js +38 -0
  87. package/dist/products/dashboard-file-cache.js.map +1 -0
  88. package/dist/products/dashboard-panels.d.ts +6 -0
  89. package/dist/products/dashboard-panels.d.ts.map +1 -0
  90. package/dist/products/dashboard-panels.js +179 -0
  91. package/dist/products/dashboard-panels.js.map +1 -0
  92. package/dist/products/dashboard-screen.d.ts +8 -0
  93. package/dist/products/dashboard-screen.d.ts.map +1 -1
  94. package/dist/products/dashboard-screen.js +86 -15
  95. package/dist/products/dashboard-screen.js.map +1 -1
  96. package/dist/products/dashboard-session-client.d.ts +16 -2
  97. package/dist/products/dashboard-session-client.d.ts.map +1 -1
  98. package/dist/products/dashboard-session-client.js +64 -11
  99. package/dist/products/dashboard-session-client.js.map +1 -1
  100. package/dist/products/dashboard-settings.d.ts.map +1 -1
  101. package/dist/products/dashboard-settings.js +4 -6
  102. package/dist/products/dashboard-settings.js.map +1 -1
  103. package/dist/products/ecosystem-versions.d.ts +1 -1
  104. package/dist/products/ecosystem-versions.d.ts.map +1 -1
  105. package/extensions/activity-timeline.ts +3 -1
  106. package/extensions/artifact-bridge.ts +130 -0
  107. package/extensions/dashboard-live.ts +63 -0
  108. package/extensions/dashboard-observation.ts +39 -0
  109. package/extensions/dashboard-session-server.ts +45 -3
  110. package/extensions/dashboard-sources.ts +124 -0
  111. package/extensions/delegation-artifacts.ts +125 -0
  112. package/extensions/delegation-operations.ts +100 -42
  113. package/extensions/ecosystem-versions.ts +12 -5
  114. package/extensions/grants-command.ts +34 -6
  115. package/extensions/grants.ts +9 -20
  116. package/extensions/initiative-dashboard.ts +143 -0
  117. package/extensions/initiative-runtime.ts +406 -0
  118. package/extensions/runtime-snapshot.ts +121 -2
  119. package/extensions/session-environment.ts +13 -1
  120. package/extensions/session.ts +28 -10
  121. package/extensions/workspace-diagnostics.ts +90 -0
  122. package/package.json +1 -1
  123. package/src/governance/initiative-coordinator.ts +400 -0
  124. package/src/governance/initiative-effects.ts +146 -0
  125. package/src/governance/initiative-state.ts +144 -0
  126. package/src/governance/operation-artifact-io.ts +103 -0
  127. package/src/governance/operation-artifact-scan.ts +77 -0
  128. package/src/governance/operation-artifacts.ts +363 -0
  129. package/src/governance/runtime-settlement.ts +28 -0
  130. package/src/governance/workspace-acceptance.ts +18 -0
  131. package/src/index.ts +13 -0
  132. package/src/kernel/dashboard-observation.ts +109 -0
  133. package/src/kernel/dispatch-operation.ts +2 -0
  134. package/src/kernel/initiative.ts +126 -0
  135. package/src/kernel/operation-artifact.ts +46 -0
  136. package/src/kernel/principal-binding.ts +104 -0
  137. package/src/kernel/project-paths.ts +16 -0
  138. package/src/kernel/selected-definitions.ts +5 -100
  139. package/src/kernel/workspace-diagnostics.ts +110 -0
  140. package/src/products/activity-storage.ts +128 -0
  141. package/src/products/activity-timeline.ts +11 -0
  142. package/src/products/dashboard-cli.ts +44 -9
  143. package/src/products/dashboard-display-controls.ts +27 -0
  144. package/src/products/dashboard-file-cache.ts +38 -0
  145. package/src/products/dashboard-panels.ts +217 -0
  146. package/src/products/dashboard-screen.ts +107 -17
  147. package/src/products/dashboard-session-client.ts +78 -14
  148. package/src/products/dashboard-settings.ts +4 -6
  149. package/src/products/ecosystem-versions.ts +2 -1
@@ -1,15 +1,11 @@
1
1
  /** Selected Pi 1.0.4 resources, frozen once per extension instance. No independent resource scan. */
2
2
  import { createHash } from "node:crypto";
3
- import { dirname, join, resolve as resolvePath } from "node:path";
4
- import { lstat, realpath } from "node:fs/promises";
3
+ import { resolve as resolvePath } from "node:path";
4
+ import { lstat } from "node:fs/promises";
5
5
  import { BoundedReadCleanupError, readBoundedBytes } from "./bounded-read.js";
6
- import { ceilingForDefinition, parseSkillDefinition } from "./definitions.js";
7
- import { resolve } from "./resolve.js";
8
- const requiredPhases = ["plan", "build", "review", "debug", "investigate"];
9
- const phases = [...requiredPhases, "test-review"];
6
+ import { parseSkillDefinition } from "./definitions.js";
7
+ import { principalBinding } from "./principal-binding.js";
10
8
  const hash = (value) => createHash("sha256").update(value, "utf8").digest("hex");
11
- const object = (x) => !!x && typeof x === "object" && !Array.isArray(x);
12
- const exact = (x, keys) => Object.keys(x).sort().join(",") === [...keys].sort().join(",");
13
9
  async function read(path, kind, sources) {
14
10
  if (!(await lstat(path)).isFile())
15
11
  throw Error(`nonregular selected resource: ${path}`);
@@ -20,88 +16,6 @@ async function read(path, kind, sources) {
20
16
  sources?.push(Object.freeze({ kind, path, base64: result.bytes.toString("base64") }));
21
17
  return text;
22
18
  }
23
- async function principalBinding(path, inline, skillText, sources) {
24
- const phase = inline.name;
25
- const marked = inline.metadata?.["principal-package"] === "principal-pi-skills";
26
- if (!phases.includes(phase) || path !== join(dirname(dirname(path)), phase, "SKILL.md")) {
27
- if (marked)
28
- throw Error("marked Principal skill has a noncanonical phase or path");
29
- return inline;
30
- }
31
- const root = dirname(dirname(path));
32
- let packageText;
33
- try {
34
- packageText = await read(join(root, "package.json"), "package", sources);
35
- }
36
- catch (error) {
37
- if (error.code === "ENOENT" && !marked)
38
- return inline;
39
- throw error;
40
- }
41
- const pkg = JSON.parse(packageText);
42
- if (!object(pkg) || pkg.name !== "principal-pi-skills") {
43
- if (marked)
44
- throw Error("marked Principal skill has missing or wrong package identity");
45
- return inline;
46
- }
47
- const manifest = JSON.parse(await read(join(root, "principal-agents.json"), "binding-manifest", sources));
48
- if (!object(manifest) ||
49
- !exact(manifest, ["version", "package", "bindings"]) ||
50
- manifest.version !== 1 ||
51
- manifest.package !== "principal-pi-skills" ||
52
- !object(manifest.bindings) ||
53
- !exact(manifest.bindings, Object.hasOwn(manifest.bindings, "test-review") ? phases : requiredPhases))
54
- throw Error("invalid Principal binding manifest");
55
- for (const name of Object.keys(manifest.bindings)) {
56
- const row = manifest.bindings[name];
57
- if (!object(row) ||
58
- !exact(row, ["skill", "agent", "skillSha256", "agentSha256"]) ||
59
- row.skill !== `${name}/SKILL.md` ||
60
- row.agent !== `agents/principal-${name}.md` ||
61
- typeof row.skillSha256 !== "string" ||
62
- !/^[a-f0-9]{64}$/.test(row.skillSha256) ||
63
- typeof row.agentSha256 !== "string" ||
64
- !/^[a-f0-9]{64}$/.test(row.agentSha256))
65
- throw Error("invalid Principal binding row");
66
- }
67
- if (!Object.hasOwn(manifest.bindings, phase))
68
- throw Error("selected Principal phase has no binding row");
69
- const row = manifest.bindings[phase];
70
- const agentPath = join(root, row.agent);
71
- if ((await realpath(agentPath)) !== join(await realpath(root), row.agent) ||
72
- (await realpath(path)) !== join(await realpath(root), row.skill))
73
- throw Error("Principal binding path escaped its selected package");
74
- const agentText = await read(agentPath, "delegated-agent", sources);
75
- if (hash(skillText) !== row.skillSha256 || hash(agentText) !== row.agentSha256)
76
- throw Error("Principal binding hash mismatch");
77
- const agent = parseSkillDefinition(agentPath, agentText);
78
- if (!agent)
79
- throw Error("Principal delegated definition is malformed");
80
- const inlineCeiling = ceilingForDefinition(inline), delegatedCeiling = ceilingForDefinition(agent);
81
- if (inlineCeiling.undeclared ||
82
- delegatedCeiling.undeclared ||
83
- inlineCeiling.patterns.length ||
84
- delegatedCeiling.patterns.length)
85
- throw Error("Principal binding needs two declared pattern-free ceilings");
86
- const ceiling = resolve({
87
- requested: delegatedCeiling.capabilities,
88
- parentGrant: inlineCeiling.capabilities,
89
- subsumption: false,
90
- }).effective;
91
- const header = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/.exec(agentText);
92
- return {
93
- ...agent,
94
- name: phase,
95
- source: agentPath,
96
- sourceHash: hash(agentText),
97
- selectedSkillHash: hash(skillText),
98
- body: agentText.slice(header[0].length),
99
- allowedTools: ceiling.join(","),
100
- runtimePreferences: agent.runtimePreferences ?? inline.runtimePreferences,
101
- ...(typeof pkg.version === "string" ? { packageVersion: pkg.version } : {}),
102
- binding: Object.freeze({ package: "principal-pi-skills", phase }),
103
- };
104
- }
105
19
  export async function selectedDefinitions(commands, captureSources = false) {
106
20
  const definitions = new Map();
107
21
  const skills = [], skips = [], seen = new Set();
@@ -124,7 +38,7 @@ export async function selectedDefinitions(commands, captureSources = false) {
124
38
  const parsed = parseSkillDefinition(path, text);
125
39
  if (!parsed || parsed.name !== name)
126
40
  throw Error("selected name/path does not match definition");
127
- const bound = await principalBinding(path, parsed, text, sources);
41
+ const bound = await principalBinding(path, parsed, text, sources, read);
128
42
  const definitionId = hash(JSON.stringify({
129
43
  name,
130
44
  source: bound.source,
@@ -1 +1 @@
1
- {"version":3,"file":"selected-definitions.js","sourceRoot":"","sources":["../../src/kernel/selected-definitions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"selected-definitions.js","sourceRoot":"","sources":["../../src/kernel/selected-definitions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { type WorkspaceRegistryFile } from "./workspace.ts";
2
+ import type { Capability } from "./resolve.ts";
3
+ import type { WorkspacePins } from "./workspace-pin.ts";
4
+ export interface WorkspaceRoutingObservation {
5
+ workspaceId: string;
6
+ state: "active" | "pending-activation" | "not-granted" | "not-pinned" | "not-registered" | "destination-changed" | "unavailable";
7
+ registered: boolean;
8
+ accepted: boolean | null;
9
+ capability: "held" | "missing";
10
+ pin: "matching" | "missing" | "moved" | "unchecked";
11
+ canonicalRoot?: string;
12
+ reason: string;
13
+ recovery: string;
14
+ dispatchChecks: string;
15
+ }
16
+ export declare function inspectWorkspaceRouting(input: {
17
+ workspaceId: string;
18
+ registry: WorkspaceRegistryFile;
19
+ accepted: boolean | null;
20
+ ownGrant: readonly Capability[];
21
+ pins?: WorkspacePins;
22
+ depth: number;
23
+ }): Promise<WorkspaceRoutingObservation>;
24
+ //# sourceMappingURL=workspace-diagnostics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-diagnostics.d.ts","sourceRoot":"","sources":["../../src/kernel/workspace-diagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EACD,QAAQ,GACR,oBAAoB,GACpB,aAAa,GACb,YAAY,GACZ,gBAAgB,GAChB,qBAAqB,GACrB,aAAa,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AACD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA4EvC"}
@@ -0,0 +1,81 @@
1
+ /** Read-only routing observations. Reuse the dispatch owners; no lease, pin, acceptance or grant mutation. */
2
+ import { checkRoutingAuthority } from "./routing-authority.js";
3
+ import { resolveWorkspace } from "./workspace.js";
4
+ import { GovernanceRefusal } from "./refusals.js";
5
+ export async function inspectWorkspaceRouting(input) {
6
+ const { workspaceId, registry, accepted } = input;
7
+ const authority = checkRoutingAuthority(workspaceId, input.ownGrant);
8
+ const registered = Object.hasOwn(registry.workspaces, workspaceId);
9
+ const pinned = input.pins?.has(workspaceId) ?? false;
10
+ const result = {
11
+ workspaceId,
12
+ registered,
13
+ accepted,
14
+ capability: authority ? "missing" : "held",
15
+ pin: pinned ? "unchecked" : "missing",
16
+ state: "unavailable",
17
+ reason: "Routing has not been checked.",
18
+ recovery: "Inspect the exact registered workspace.",
19
+ dispatchChecks: "Observed routing only; candidate, selected task/input scope, approvals, lease and native settlement " +
20
+ "are checked by their owners at dispatch.",
21
+ };
22
+ if (!registered)
23
+ return {
24
+ ...result,
25
+ state: "not-registered",
26
+ reason: pinned
27
+ ? "This session pinned the ID, but its registry entry has been removed."
28
+ : "The ID is absent from the current registry.",
29
+ recovery: "Review the registry with the operator. A remembered or removed ID does not authorize another directory.",
30
+ };
31
+ try {
32
+ const workspace = await resolveWorkspace(registry, workspaceId, { pins: input.pins ?? new Map() });
33
+ result.canonicalRoot = workspace.root;
34
+ result.pin = "matching";
35
+ }
36
+ catch (error) {
37
+ if (!(error instanceof GovernanceRefusal))
38
+ throw error;
39
+ result.reason = error.message;
40
+ if (error.code === "WORKSPACE_NOT_AUTHORIZED" && typeof error.details?.resolved_root === "string") {
41
+ result.canonicalRoot = error.details.resolved_root;
42
+ if (pinned)
43
+ return {
44
+ ...result,
45
+ pin: "moved",
46
+ state: "destination-changed",
47
+ recovery: "The registered destination differs from this owner's pin. Review the change; reload cannot repin and no session is started automatically.",
48
+ };
49
+ result.state = accepted === true && input.depth === 0 ? "pending-activation" : "not-pinned";
50
+ result.recovery =
51
+ input.depth > 0
52
+ ? "Ask the parent owner to select and grant the exact workspace. A descendant cannot mint its own pin."
53
+ : accepted === true
54
+ ? "Already accepted, but absent from this owner's settled pin. " +
55
+ "Use an explicitly selected new root session after reviewing its destination; reload keeps the old pin."
56
+ : "Review workspace acceptance with /grants workspaces. Acceptance applies to a new root session; reload does not create pins.";
57
+ }
58
+ else {
59
+ result.recovery =
60
+ "Correct the reported registry or Git-worktree problem. Routing requires the exact worktree root, not a subdirectory.";
61
+ return result;
62
+ }
63
+ }
64
+ if (authority)
65
+ return {
66
+ ...result,
67
+ state: "not-granted",
68
+ reason: authority.reason,
69
+ recovery: "This current grant lacks routing authority (never granted or revoked). " +
70
+ "The operator or parent must grant this exact ID; registration and acceptance do not grant it.",
71
+ };
72
+ if (result.pin !== "matching")
73
+ return result;
74
+ return {
75
+ ...result,
76
+ state: "active",
77
+ reason: "The current capability and settled destination pin match a valid registered worktree.",
78
+ recovery: "Reuse this workspace ID for the authorized operation. Dispatch still checks its current scope and execution prerequisites.",
79
+ };
80
+ }
81
+ //# sourceMappingURL=workspace-diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-diagnostics.js","sourceRoot":"","sources":["../../src/kernel/workspace-diagnostics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function prepareDefaultActivityStorage(cwd: string, path: string): Promise<void>;
2
+ //# sourceMappingURL=activity-storage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity-storage.d.ts","sourceRoot":"","sources":["../../src/products/activity-storage.ts"],"names":[],"mappings":"AA+CA,wBAAsB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgF5F"}
@@ -0,0 +1,119 @@
1
+ /** Initialize default activity storage once per recorder, before observing product identity. */
2
+ import { constants } from "node:fs";
3
+ import { lstat, mkdir, open, realpath } from "node:fs/promises";
4
+ import { execFile } from "node:child_process";
5
+ import { promisify } from "node:util";
6
+ import { dirname, join, resolve } from "node:path";
7
+ import { ACTIVITY_GITIGNORE_CONTENT, activityTimelinePath, piProjectDir, projectGitignorePath, projectStateDir, } from "../kernel/project-paths.js";
8
+ const execute = promisify(execFile);
9
+ const missing = (error) => error.code === "ENOENT";
10
+ async function ordinaryDirectory(path) {
11
+ try {
12
+ await mkdir(path, { mode: 0o700 });
13
+ }
14
+ catch (error) {
15
+ if (error.code !== "EEXIST")
16
+ throw error;
17
+ }
18
+ const info = await lstat(path);
19
+ if (!info.isDirectory() || info.isSymbolicLink())
20
+ throw Error("activity storage path is not an ordinary directory; nothing followed or replaced");
21
+ }
22
+ /** Without Git, allow ordinary non-repository roles but never guess that a marked repo is safe. */
23
+ async function markerFreeNonRepository(cwd) {
24
+ if (["GIT_DIR", "GIT_WORK_TREE", "GIT_COMMON_DIR", "GIT_INDEX_FILE"].some((key) => process.env[key]?.trim()))
25
+ return false;
26
+ let current = await realpath(cwd);
27
+ for (let depth = 0; depth < 128; depth++) {
28
+ try {
29
+ await lstat(join(current, ".git"));
30
+ return false;
31
+ }
32
+ catch (error) {
33
+ if (!missing(error))
34
+ throw error;
35
+ }
36
+ const parent = dirname(current);
37
+ if (parent === current)
38
+ return true;
39
+ current = parent;
40
+ }
41
+ return false;
42
+ }
43
+ export async function prepareDefaultActivityStorage(cwd, path) {
44
+ // Configured and transported locations retain their explicit existing policy.
45
+ if (resolve(path) !== activityTimelinePath(cwd))
46
+ return;
47
+ const root = resolve(cwd), ignore = projectGitignorePath(root), state = projectStateDir(root);
48
+ const git = (...args) => execute("git", ["--no-optional-locks", ...(args[0] === "ls-files" ? ["--literal-pathspecs"] : []), "-C", root, ...args], {
49
+ encoding: "utf8",
50
+ maxBuffer: 64 * 1024,
51
+ timeout: 2000,
52
+ env: { ...process.env, LC_ALL: "C" },
53
+ });
54
+ let repository = true;
55
+ try {
56
+ await git("rev-parse", "--show-toplevel");
57
+ }
58
+ catch (error) {
59
+ const result = error;
60
+ if ((result.code === "ENOENT" || (result.code === 128 && result.stderr?.includes("not a git repository"))) &&
61
+ (await markerFreeNonRepository(root)))
62
+ repository = false;
63
+ else
64
+ throw Error("activity Git policy could not be checked; recording unavailable");
65
+ }
66
+ if (repository) {
67
+ const tracked = await git("ls-files", "-z", "--", path, `${path}.lock`, join(state, "content"));
68
+ if (tracked.stdout.length)
69
+ throw Error("activity runtime files are already tracked; no index or ignore policy was changed");
70
+ }
71
+ await ordinaryDirectory(piProjectDir(root));
72
+ await ordinaryDirectory(state);
73
+ let present = true;
74
+ try {
75
+ const info = await lstat(ignore);
76
+ if (!info.isFile() || info.isSymbolicLink())
77
+ throw Error("activity ignore path is not an ordinary file; nothing followed or replaced");
78
+ }
79
+ catch (error) {
80
+ if (missing(error))
81
+ present = false;
82
+ else
83
+ throw error;
84
+ }
85
+ if (!present) {
86
+ if (repository && (await git("ls-files", "-z", "--", ignore)).stdout.length)
87
+ throw Error("tracked ignore file is missing; recording did not recreate it");
88
+ try {
89
+ const file = await open(ignore, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), 0o600);
90
+ try {
91
+ await file.writeFile(ACTIVITY_GITIGNORE_CONTENT, "utf8");
92
+ }
93
+ finally {
94
+ await file.close();
95
+ }
96
+ }
97
+ catch (error) {
98
+ if (error.code !== "EEXIST")
99
+ throw error;
100
+ // Another cooperating initializer won. Preserve its file and validate its policy below.
101
+ }
102
+ }
103
+ const installed = await lstat(ignore);
104
+ if (!installed.isFile() || installed.isSymbolicLink())
105
+ throw Error("activity ignore path changed; recording unavailable");
106
+ if (repository) {
107
+ // Require the directory itself to be excluded: one sample digest cannot prove that
108
+ // custom rules cover every digest and temporary filename.
109
+ for (const probe of [path, `${path}.lock`, `${join(state, "content")}/`]) {
110
+ try {
111
+ await git("check-ignore", "-q", "--", probe);
112
+ }
113
+ catch {
114
+ throw Error("existing Git policy does not exclude default activity storage; existing rules were preserved and recording is unavailable");
115
+ }
116
+ }
117
+ }
118
+ }
119
+ //# sourceMappingURL=activity-storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity-storage.js","sourceRoot":"","sources":["../../src/products/activity-storage.ts"],"names":[],"mappings":"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"}
@@ -125,7 +125,11 @@ export declare class ActivityTimelineRecorder {
125
125
  readonly rootId: string;
126
126
  readonly episodeId: string;
127
127
  private taskId?;
128
+ private storageReady?;
129
+ private readonly cwd;
128
130
  constructor(cwd: string, env?: NodeJS.ProcessEnv);
131
+ /** Await during session_start. Direct recorder users also pass this before any write. */
132
+ prepareStorage(): Promise<void>;
129
133
  get task(): string | undefined;
130
134
  /** No id detaches a completed root before observing a new, possibly rejected start. */
131
135
  attach(taskId?: string): void;
@@ -1 +1 @@
1
- {"version":3,"file":"activity-timeline.d.ts","sourceRoot":"","sources":["../../src/products/activity-timeline.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"activity-timeline.d.ts","sourceRoot":"","sources":["../../src/products/activity-timeline.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,7 @@ import { constants } from "node:fs";
4
4
  import { appendFile, mkdir, open, readFile, realpath, rename, writeFile } from "node:fs/promises";
5
5
  import { dirname, join, resolve, sep } from "node:path";
6
6
  import { activityTimelinePath } from "../kernel/project-paths.js";
7
+ import { prepareDefaultActivityStorage } from "./activity-storage.js";
7
8
  import { isEpisodeId, newEpisodeId } from "../kernel/episode-id.js";
8
9
  import { ENV_EPISODE_ID } from "../kernel/env-names.js";
9
10
  import { appendRecord, readRecords } from "../governance/record.js";
@@ -440,7 +441,10 @@ export class ActivityTimelineRecorder {
440
441
  rootId;
441
442
  episodeId;
442
443
  taskId;
444
+ storageReady;
445
+ cwd;
443
446
  constructor(cwd, env = process.env) {
447
+ this.cwd = cwd;
444
448
  const configured = env[ENV_ACTIVITY_TIMELINE]?.trim();
445
449
  this.enabled = configured !== "off" && configured !== "0";
446
450
  this.contentEnabled =
@@ -452,6 +456,12 @@ export class ActivityTimelineRecorder {
452
456
  this.episodeId = isEpisodeId(inheritedEpisodeId) ? inheritedEpisodeId : newEpisodeId();
453
457
  this.taskId = identity.taskId;
454
458
  }
459
+ /** Await during session_start. Direct recorder users also pass this before any write. */
460
+ prepareStorage() {
461
+ if (!this.enabled)
462
+ return Promise.resolve();
463
+ return (this.storageReady ??= prepareDefaultActivityStorage(this.cwd, this.path));
464
+ }
455
465
  get task() {
456
466
  return this.taskId;
457
467
  }
@@ -510,6 +520,7 @@ export class ActivityTimelineRecorder {
510
520
  async append(kind, fields) {
511
521
  if (!this.enabled || !this.taskId)
512
522
  return;
523
+ await this.prepareStorage();
513
524
  const event = {
514
525
  version: 1,
515
526
  id: randomUUID(),
@@ -527,6 +538,7 @@ export class ActivityTimelineRecorder {
527
538
  await appendRecord(this.path, "activity", event); // ADR-0076 PR 3d: envelope, lock, damage refusal
528
539
  }
529
540
  async content(value) {
541
+ await this.prepareStorage();
530
542
  const digest = sha(value), bytes = Buffer.byteLength(value);
531
543
  if (!this.contentEnabled || bytes > MAX_CONTENT_BYTES)
532
544
  return { digest, bytes };