@phyzess/pappra 0.0.0-stage → 0.1.0-beta.2

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 (221) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +80 -2
  3. package/THIRD_PARTY_NOTICES.md +16 -0
  4. package/assets/integrations/skills/pappra/SKILL.md +68 -0
  5. package/assets/integrations/skills/pappra/references/hosts.md +30 -0
  6. package/assets/integrations/skills/pappra/references/lifecycle.md +37 -0
  7. package/assets/integrations/skills/pappra/references/operations.md +14 -0
  8. package/assets/manifest.json +4 -0
  9. package/dist/app/collaboration.d.ts +170 -0
  10. package/dist/app/collaboration.js +1650 -0
  11. package/dist/app/doctor.d.ts +9 -0
  12. package/dist/app/doctor.js +1030 -0
  13. package/dist/app/init.d.ts +143 -0
  14. package/dist/app/init.js +1111 -0
  15. package/dist/cli/commands/code.d.ts +16 -0
  16. package/dist/cli/commands/code.js +127 -0
  17. package/dist/cli/commands/collaboration.d.ts +13 -0
  18. package/dist/cli/commands/collaboration.js +186 -0
  19. package/dist/cli/commands/continuity.d.ts +29 -0
  20. package/dist/cli/commands/continuity.js +133 -0
  21. package/dist/cli/commands/docs.d.ts +11 -0
  22. package/dist/cli/commands/docs.js +133 -0
  23. package/dist/cli/commands/doctor.d.ts +14 -0
  24. package/dist/cli/commands/doctor.js +57 -0
  25. package/dist/cli/commands/host.d.ts +13 -0
  26. package/dist/cli/commands/host.js +125 -0
  27. package/dist/cli/commands/init.d.ts +51 -0
  28. package/dist/cli/commands/init.js +668 -0
  29. package/dist/cli/main.d.ts +2 -0
  30. package/dist/cli/main.js +10 -0
  31. package/dist/cli/output.d.ts +4 -0
  32. package/dist/cli/output.js +1 -0
  33. package/dist/cli/run.d.ts +2 -0
  34. package/dist/cli/run.js +597 -0
  35. package/dist/code/budget.d.ts +14 -0
  36. package/dist/code/budget.js +39 -0
  37. package/dist/code/exec.d.ts +23 -0
  38. package/dist/code/exec.js +133 -0
  39. package/dist/code/identity.d.ts +13 -0
  40. package/dist/code/identity.js +214 -0
  41. package/dist/code/index.d.ts +6 -0
  42. package/dist/code/index.js +3 -0
  43. package/dist/code/providers/codegraph.d.ts +59 -0
  44. package/dist/code/providers/codegraph.js +567 -0
  45. package/dist/code/registration.d.ts +9 -0
  46. package/dist/code/registration.js +293 -0
  47. package/dist/code/service.d.ts +53 -0
  48. package/dist/code/service.js +633 -0
  49. package/dist/code/text.d.ts +3 -0
  50. package/dist/code/text.js +202 -0
  51. package/dist/collab/admission.d.ts +450 -0
  52. package/dist/collab/admission.js +797 -0
  53. package/dist/collab/canonical.d.ts +26 -0
  54. package/dist/collab/canonical.js +136 -0
  55. package/dist/collab/contracts.d.ts +73 -0
  56. package/dist/collab/contracts.js +76 -0
  57. package/dist/collab/envelope.d.ts +52 -0
  58. package/dist/collab/envelope.js +241 -0
  59. package/dist/collab/fingerprint.d.ts +7 -0
  60. package/dist/collab/fingerprint.js +58 -0
  61. package/dist/collab/handoff.d.ts +350 -0
  62. package/dist/collab/handoff.js +513 -0
  63. package/dist/collab/index.d.ts +9 -0
  64. package/dist/collab/index.js +8 -0
  65. package/dist/collab/lifecycle.d.ts +449 -0
  66. package/dist/collab/lifecycle.js +534 -0
  67. package/dist/collab/messages.d.ts +148 -0
  68. package/dist/collab/messages.js +583 -0
  69. package/dist/collab/notify.d.ts +47 -0
  70. package/dist/collab/notify.js +140 -0
  71. package/dist/collab/preflight.d.ts +31 -0
  72. package/dist/collab/preflight.js +271 -0
  73. package/dist/collab/resources.d.ts +119 -0
  74. package/dist/collab/resources.js +451 -0
  75. package/dist/collab/store.d.ts +143 -0
  76. package/dist/collab/store.js +606 -0
  77. package/dist/collab/types.d.ts +354 -0
  78. package/dist/collab/types.js +1 -0
  79. package/dist/collab/validation.d.ts +10 -0
  80. package/dist/collab/validation.js +303 -0
  81. package/dist/continuity/context.d.ts +24 -0
  82. package/dist/continuity/context.js +179 -0
  83. package/dist/continuity/index.d.ts +3 -0
  84. package/dist/continuity/index.js +1 -0
  85. package/dist/continuity/paths.d.ts +37 -0
  86. package/dist/continuity/paths.js +258 -0
  87. package/dist/continuity/service.d.ts +59 -0
  88. package/dist/continuity/service.js +1258 -0
  89. package/dist/hosts/claude/native.d.ts +79 -0
  90. package/dist/hosts/claude/native.js +853 -0
  91. package/dist/hosts/codex/native.d.ts +345 -0
  92. package/dist/hosts/codex/native.js +1528 -0
  93. package/dist/hosts/codex/protocol.d.ts +51 -0
  94. package/dist/hosts/codex/protocol.js +42 -0
  95. package/dist/hosts/detect.d.ts +28 -0
  96. package/dist/hosts/detect.js +73 -0
  97. package/dist/hosts/index.d.ts +10 -0
  98. package/dist/hosts/index.js +10 -0
  99. package/dist/hosts/integration/bundle.d.ts +16 -0
  100. package/dist/hosts/integration/bundle.js +81 -0
  101. package/dist/hosts/integration/hook-entry.d.ts +1 -0
  102. package/dist/hosts/integration/hook-entry.js +68 -0
  103. package/dist/hosts/integration/hook.d.ts +32 -0
  104. package/dist/hosts/integration/hook.js +781 -0
  105. package/dist/hosts/integration/pi-extension-runtime.d.ts +18 -0
  106. package/dist/hosts/integration/pi-extension-runtime.js +89 -0
  107. package/dist/hosts/integration/pi-template.d.ts +3 -0
  108. package/dist/hosts/integration/pi-template.js +5 -0
  109. package/dist/hosts/integration/service.d.ts +41 -0
  110. package/dist/hosts/integration/service.js +1381 -0
  111. package/dist/hosts/integration/support.d.ts +36 -0
  112. package/dist/hosts/integration/support.js +41 -0
  113. package/dist/hosts/integration/templates.d.ts +22 -0
  114. package/dist/hosts/integration/templates.js +70 -0
  115. package/dist/hosts/pi/protocol.d.ts +22 -0
  116. package/dist/hosts/pi/protocol.js +28 -0
  117. package/dist/hosts/pi/query-result.d.ts +22 -0
  118. package/dist/hosts/pi/query-result.js +710 -0
  119. package/dist/hosts/pi/rpc.d.ts +937 -0
  120. package/dist/hosts/pi/rpc.js +1621 -0
  121. package/dist/hosts/pilot.d.ts +485 -0
  122. package/dist/hosts/pilot.js +593 -0
  123. package/dist/index.d.ts +5 -0
  124. package/dist/index.js +4 -0
  125. package/dist/infra/fs.d.ts +27 -0
  126. package/dist/infra/fs.js +130 -0
  127. package/dist/infra/git.d.ts +60 -0
  128. package/dist/infra/git.js +358 -0
  129. package/dist/infra/owned-process-group.d.ts +173 -0
  130. package/dist/infra/owned-process-group.js +571 -0
  131. package/dist/install/apply.d.ts +65 -0
  132. package/dist/install/apply.js +663 -0
  133. package/dist/install/index.d.ts +5 -0
  134. package/dist/install/index.js +5 -0
  135. package/dist/install/ownership.d.ts +85 -0
  136. package/dist/install/ownership.js +430 -0
  137. package/dist/install/plan.d.ts +39 -0
  138. package/dist/install/plan.js +97 -0
  139. package/dist/install/rollback.d.ts +18 -0
  140. package/dist/install/rollback.js +544 -0
  141. package/dist/install/runtime.d.ts +76 -0
  142. package/dist/install/runtime.js +1145 -0
  143. package/dist/knowledge/catalog.d.ts +47 -0
  144. package/dist/knowledge/catalog.js +308 -0
  145. package/dist/knowledge/context.d.ts +28 -0
  146. package/dist/knowledge/context.js +61 -0
  147. package/dist/knowledge/index.d.ts +3 -0
  148. package/dist/knowledge/index.js +1 -0
  149. package/dist/knowledge/journal.d.ts +16 -0
  150. package/dist/knowledge/journal.js +109 -0
  151. package/dist/knowledge/lifecycle.d.ts +8 -0
  152. package/dist/knowledge/lifecycle.js +1001 -0
  153. package/dist/knowledge/paths.d.ts +37 -0
  154. package/dist/knowledge/paths.js +236 -0
  155. package/dist/knowledge/refs.d.ts +36 -0
  156. package/dist/knowledge/refs.js +267 -0
  157. package/dist/knowledge/service.d.ts +21 -0
  158. package/dist/knowledge/service.js +393 -0
  159. package/dist/knowledge/types.d.ts +171 -0
  160. package/dist/knowledge/types.js +1 -0
  161. package/dist/knowledge/write.d.ts +8 -0
  162. package/dist/knowledge/write.js +1223 -0
  163. package/dist/package-info.d.ts +6 -0
  164. package/dist/package-info.js +19 -0
  165. package/dist/schemas/code.d.ts +377 -0
  166. package/dist/schemas/code.js +145 -0
  167. package/dist/schemas/collaboration.d.ts +115 -0
  168. package/dist/schemas/collaboration.js +106 -0
  169. package/dist/schemas/continuity.d.ts +315 -0
  170. package/dist/schemas/continuity.js +199 -0
  171. package/dist/schemas/diagnostics.d.ts +28 -0
  172. package/dist/schemas/diagnostics.js +27 -0
  173. package/dist/schemas/doctor.d.ts +157 -0
  174. package/dist/schemas/doctor.js +75 -0
  175. package/dist/schemas/document.d.ts +644 -0
  176. package/dist/schemas/document.js +296 -0
  177. package/dist/schemas/errors.d.ts +177 -0
  178. package/dist/schemas/errors.js +176 -0
  179. package/dist/schemas/evidence.d.ts +24 -0
  180. package/dist/schemas/evidence.js +16 -0
  181. package/dist/schemas/host.d.ts +436 -0
  182. package/dist/schemas/host.js +201 -0
  183. package/dist/schemas/index.d.ts +15 -0
  184. package/dist/schemas/index.js +15 -0
  185. package/dist/schemas/init.d.ts +121 -0
  186. package/dist/schemas/init.js +94 -0
  187. package/dist/schemas/install.d.ts +213 -0
  188. package/dist/schemas/install.js +139 -0
  189. package/dist/schemas/machine.d.ts +43 -0
  190. package/dist/schemas/machine.js +96 -0
  191. package/dist/schemas/outcome.d.ts +23 -0
  192. package/dist/schemas/outcome.js +17 -0
  193. package/dist/schemas/paths.d.ts +19 -0
  194. package/dist/schemas/paths.js +63 -0
  195. package/dist/schemas/workspace.d.ts +120 -0
  196. package/dist/schemas/workspace.js +201 -0
  197. package/dist/workspace/config-file.d.ts +36 -0
  198. package/dist/workspace/config-file.js +237 -0
  199. package/dist/workspace/config.d.ts +28 -0
  200. package/dist/workspace/config.js +79 -0
  201. package/dist/workspace/discover.d.ts +34 -0
  202. package/dist/workspace/discover.js +195 -0
  203. package/dist/workspace/documents.d.ts +21 -0
  204. package/dist/workspace/documents.js +395 -0
  205. package/dist/workspace/ignore.d.ts +10 -0
  206. package/dist/workspace/ignore.js +48 -0
  207. package/dist/workspace/index.d.ts +7 -0
  208. package/dist/workspace/index.js +3 -0
  209. package/dist/workspace/repositories.d.ts +24 -0
  210. package/dist/workspace/repositories.js +411 -0
  211. package/dist/workspace/resolve.d.ts +24 -0
  212. package/dist/workspace/resolve.js +268 -0
  213. package/dist/workspace/types.d.ts +71 -0
  214. package/dist/workspace/types.js +1 -0
  215. package/dist/workspace/validation.d.ts +18 -0
  216. package/dist/workspace/validation.js +197 -0
  217. package/package.json +105 -4
  218. package/skills/pappra/SKILL.md +68 -0
  219. package/skills/pappra/references/hosts.md +30 -0
  220. package/skills/pappra/references/lifecycle.md +37 -0
  221. package/skills/pappra/references/operations.md +14 -0
@@ -0,0 +1,157 @@
1
+ import { z } from 'zod';
2
+ export declare const DOCTOR_REPORT_SCHEMA = "pappra/doctor-report/1";
3
+ export declare const doctorCheckStatusSchema: z.ZodEnum<{
4
+ error: "error";
5
+ ok: "ok";
6
+ partial: "partial";
7
+ unknown: "unknown";
8
+ unsupported: "unsupported";
9
+ warning: "warning";
10
+ }>;
11
+ export declare const doctorSeveritySchema: z.ZodEnum<{
12
+ error: "error";
13
+ info: "info";
14
+ warning: "warning";
15
+ }>;
16
+ export declare const doctorCheckSchema: z.ZodObject<{
17
+ id: z.ZodString;
18
+ code: z.ZodString;
19
+ status: z.ZodEnum<{
20
+ error: "error";
21
+ ok: "ok";
22
+ partial: "partial";
23
+ unknown: "unknown";
24
+ unsupported: "unsupported";
25
+ warning: "warning";
26
+ }>;
27
+ severity: z.ZodEnum<{
28
+ error: "error";
29
+ info: "info";
30
+ warning: "warning";
31
+ }>;
32
+ title: z.ZodString;
33
+ summary: z.ZodString;
34
+ source: z.ZodString;
35
+ observedAt: z.ZodISODateTime;
36
+ coverage: z.ZodNullable<z.ZodString>;
37
+ evidence: z.ZodArray<z.ZodObject<{
38
+ kind: z.ZodEnum<{
39
+ file: "file";
40
+ git: "git";
41
+ "native-event": "native-event";
42
+ "runtime-probe": "runtime-probe";
43
+ }>;
44
+ ref: z.ZodString;
45
+ digest: z.ZodNullable<z.ZodString>;
46
+ observedAt: z.ZodISODateTime;
47
+ scope: z.ZodEnum<{
48
+ declared: "declared";
49
+ "live-owned": "live-owned";
50
+ persisted: "persisted";
51
+ }>;
52
+ }, z.core.$strict>>;
53
+ nextActions: z.ZodArray<z.ZodString>;
54
+ }, z.core.$strict>;
55
+ export type DoctorCheckStatus = z.infer<typeof doctorCheckStatusSchema>;
56
+ export type DoctorSeverity = z.infer<typeof doctorSeveritySchema>;
57
+ export type DoctorCheck = z.infer<typeof doctorCheckSchema>;
58
+ export declare const doctorMachineRuntimeSchema: z.ZodObject<{
59
+ version: z.ZodString;
60
+ executable: z.ZodString;
61
+ verifiedAt: z.ZodISODateTime;
62
+ }, z.core.$strict>;
63
+ export declare const doctorReportSchema: z.ZodObject<{
64
+ schema: z.ZodLiteral<"pappra/doctor-report/1">;
65
+ generatedAt: z.ZodISODateTime;
66
+ requestedRoot: z.ZodString;
67
+ workspace: z.ZodObject<{
68
+ root: z.ZodNullable<z.ZodString>;
69
+ state: z.ZodEnum<{
70
+ incomplete: "incomplete";
71
+ missing: "missing";
72
+ registered: "registered";
73
+ unavailable: "unavailable";
74
+ }>;
75
+ configPath: z.ZodNullable<z.ZodString>;
76
+ machinePath: z.ZodNullable<z.ZodString>;
77
+ }, z.core.$strict>;
78
+ runtime: z.ZodObject<{
79
+ targetVersion: z.ZodNullable<z.ZodString>;
80
+ machineRuntime: z.ZodNullable<z.ZodObject<{
81
+ version: z.ZodString;
82
+ executable: z.ZodString;
83
+ verifiedAt: z.ZodISODateTime;
84
+ }, z.core.$strict>>;
85
+ dataDir: z.ZodString;
86
+ passiveStatus: z.ZodNullable<z.ZodEnum<{
87
+ "content-match": "content-match";
88
+ corrupt: "corrupt";
89
+ locked: "locked";
90
+ missing: "missing";
91
+ partial: "partial";
92
+ unreadable: "unreadable";
93
+ "version-mismatch": "version-mismatch";
94
+ }>>;
95
+ }, z.core.$strict>;
96
+ scope: z.ZodObject<{
97
+ checked: z.ZodArray<z.ZodString>;
98
+ notChecked: z.ZodArray<z.ZodString>;
99
+ }, z.core.$strict>;
100
+ checks: z.ZodArray<z.ZodObject<{
101
+ id: z.ZodString;
102
+ code: z.ZodString;
103
+ status: z.ZodEnum<{
104
+ error: "error";
105
+ ok: "ok";
106
+ partial: "partial";
107
+ unknown: "unknown";
108
+ unsupported: "unsupported";
109
+ warning: "warning";
110
+ }>;
111
+ severity: z.ZodEnum<{
112
+ error: "error";
113
+ info: "info";
114
+ warning: "warning";
115
+ }>;
116
+ title: z.ZodString;
117
+ summary: z.ZodString;
118
+ source: z.ZodString;
119
+ observedAt: z.ZodISODateTime;
120
+ coverage: z.ZodNullable<z.ZodString>;
121
+ evidence: z.ZodArray<z.ZodObject<{
122
+ kind: z.ZodEnum<{
123
+ file: "file";
124
+ git: "git";
125
+ "native-event": "native-event";
126
+ "runtime-probe": "runtime-probe";
127
+ }>;
128
+ ref: z.ZodString;
129
+ digest: z.ZodNullable<z.ZodString>;
130
+ observedAt: z.ZodISODateTime;
131
+ scope: z.ZodEnum<{
132
+ declared: "declared";
133
+ "live-owned": "live-owned";
134
+ persisted: "persisted";
135
+ }>;
136
+ }, z.core.$strict>>;
137
+ nextActions: z.ZodArray<z.ZodString>;
138
+ }, z.core.$strict>>;
139
+ summary: z.ZodObject<{
140
+ status: z.ZodEnum<{
141
+ blocked: "blocked";
142
+ needs_attention: "needs_attention";
143
+ ok: "ok";
144
+ }>;
145
+ exitCode: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>;
146
+ counts: z.ZodObject<{
147
+ ok: z.ZodNumber;
148
+ warning: z.ZodNumber;
149
+ error: z.ZodNumber;
150
+ unknown: z.ZodNumber;
151
+ partial: z.ZodNumber;
152
+ unsupported: z.ZodNumber;
153
+ }, z.core.$strict>;
154
+ nextActions: z.ZodArray<z.ZodString>;
155
+ }, z.core.$strict>;
156
+ }, z.core.$strict>;
157
+ export type DoctorReport = z.infer<typeof doctorReportSchema>;
@@ -0,0 +1,75 @@
1
+ import { z } from 'zod';
2
+ import { evidenceRefSchema } from './evidence.js';
3
+ export const DOCTOR_REPORT_SCHEMA = 'pappra/doctor-report/1';
4
+ export const doctorCheckStatusSchema = z.enum([
5
+ 'ok',
6
+ 'warning',
7
+ 'error',
8
+ 'unknown',
9
+ 'partial',
10
+ 'unsupported',
11
+ ]);
12
+ export const doctorSeveritySchema = z.enum(['info', 'warning', 'error']);
13
+ export const doctorCheckSchema = z.strictObject({
14
+ id: z.string().min(1).max(128),
15
+ code: z.string().min(1).max(128),
16
+ status: doctorCheckStatusSchema,
17
+ severity: doctorSeveritySchema,
18
+ title: z.string().min(1).max(256),
19
+ summary: z.string().min(1).max(4096),
20
+ source: z.string().min(1).max(4096),
21
+ observedAt: z.iso.datetime({ offset: true }),
22
+ coverage: z.string().min(1).max(256).nullable(),
23
+ evidence: z.array(evidenceRefSchema).max(32),
24
+ nextActions: z.array(z.string().min(1).max(1024)).max(16),
25
+ });
26
+ export const doctorMachineRuntimeSchema = z.strictObject({
27
+ version: z.string().min(1).max(128),
28
+ executable: z.string().min(1).max(4096),
29
+ verifiedAt: z.iso.datetime({ offset: true }),
30
+ });
31
+ export const doctorReportSchema = z.strictObject({
32
+ schema: z.literal(DOCTOR_REPORT_SCHEMA),
33
+ generatedAt: z.iso.datetime({ offset: true }),
34
+ requestedRoot: z.string().min(1).max(4096),
35
+ workspace: z.strictObject({
36
+ root: z.string().min(1).max(4096).nullable(),
37
+ state: z.enum(['registered', 'missing', 'incomplete', 'unavailable']),
38
+ configPath: z.string().min(1).max(4096).nullable(),
39
+ machinePath: z.string().min(1).max(4096).nullable(),
40
+ }),
41
+ runtime: z.strictObject({
42
+ targetVersion: z.string().min(1).max(128).nullable(),
43
+ machineRuntime: doctorMachineRuntimeSchema.nullable(),
44
+ dataDir: z.string().min(1).max(4096),
45
+ passiveStatus: z
46
+ .enum([
47
+ 'missing',
48
+ 'content-match',
49
+ 'version-mismatch',
50
+ 'corrupt',
51
+ 'locked',
52
+ 'partial',
53
+ 'unreadable',
54
+ ])
55
+ .nullable(),
56
+ }),
57
+ scope: z.strictObject({
58
+ checked: z.array(z.string().min(1).max(512)).max(64),
59
+ notChecked: z.array(z.string().min(1).max(512)).max(64),
60
+ }),
61
+ checks: z.array(doctorCheckSchema).max(128),
62
+ summary: z.strictObject({
63
+ status: z.enum(['ok', 'needs_attention', 'blocked']),
64
+ exitCode: z.union([z.literal(0), z.literal(1)]),
65
+ counts: z.strictObject({
66
+ ok: z.number().int().nonnegative(),
67
+ warning: z.number().int().nonnegative(),
68
+ error: z.number().int().nonnegative(),
69
+ unknown: z.number().int().nonnegative(),
70
+ partial: z.number().int().nonnegative(),
71
+ unsupported: z.number().int().nonnegative(),
72
+ }),
73
+ nextActions: z.array(z.string().min(1).max(1024)).max(16),
74
+ }),
75
+ });