nexakit 0.0.0-stage → 0.2.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 (438) hide show
  1. package/.claude-plugin/marketplace.json +28 -0
  2. package/LICENSE +26 -0
  3. package/README.md +79 -2
  4. package/agents/claude/docs-researcher.md +9 -0
  5. package/agents/claude/implementation-tutor.md +9 -0
  6. package/agents/claude/project-explorer.md +9 -0
  7. package/agents/claude/quality-reviewer.md +9 -0
  8. package/agents/claude/requirements-analyst.md +9 -0
  9. package/agents/claude/solution-architect.md +9 -0
  10. package/agents/codex/docs-researcher.toml +10 -0
  11. package/agents/codex/implementation-tutor.toml +10 -0
  12. package/agents/codex/project-explorer.toml +10 -0
  13. package/agents/codex/quality-reviewer.toml +10 -0
  14. package/agents/codex/requirements-analyst.toml +11 -0
  15. package/agents/codex/solution-architect.toml +10 -0
  16. package/assets/brand/README.md +38 -0
  17. package/assets/brand/agent-toolkit-mark.png +0 -0
  18. package/assets/brand/agent-toolkit-mark.svg +13 -0
  19. package/assets/brand/agent-toolkit-tui-hero.png +0 -0
  20. package/assets/brand/nexakit-readme-hero.png +0 -0
  21. package/assets/brand/nexakit-readme-hero.svg +21 -0
  22. package/assets/runtime/package-lock.json +1425 -0
  23. package/bin/agent-task.js +14 -0
  24. package/bin/agent-toolkit-gemini.js +13 -0
  25. package/bin/agent-toolkit-inbox.js +14 -0
  26. package/bin/agent-toolkit-mcp.js +17 -0
  27. package/bin/agent-toolkit.js +13 -0
  28. package/bin/nexakit.js +13 -0
  29. package/bin/project-memory-mcp.js +22 -0
  30. package/bin/project-memory.js +7 -0
  31. package/catalogs/skills/api-design-principles/LICENSE.txt +21 -0
  32. package/catalogs/skills/api-design-principles/SKILL.md +110 -0
  33. package/catalogs/skills/api-design-principles/assets/api-design-checklist.md +155 -0
  34. package/catalogs/skills/api-design-principles/assets/rest-api-template.py +185 -0
  35. package/catalogs/skills/api-design-principles/references/details.md +413 -0
  36. package/catalogs/skills/api-design-principles/references/graphql-schema-design.md +589 -0
  37. package/catalogs/skills/api-design-principles/references/rest-best-practices.md +408 -0
  38. package/catalogs/skills/nodejs-backend-patterns/LICENSE.txt +21 -0
  39. package/catalogs/skills/nodejs-backend-patterns/SKILL.md +45 -0
  40. package/catalogs/skills/nodejs-backend-patterns/references/advanced-patterns.md +430 -0
  41. package/catalogs/skills/nodejs-backend-patterns/references/details.md +599 -0
  42. package/catalogs/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  43. package/catalogs/skills/supabase-postgres-best-practices/LICENSE.txt +21 -0
  44. package/catalogs/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  45. package/catalogs/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  46. package/catalogs/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  47. package/catalogs/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  48. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  49. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  50. package/catalogs/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  51. package/catalogs/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  52. package/catalogs/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  53. package/catalogs/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  54. package/catalogs/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  55. package/catalogs/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  56. package/catalogs/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  57. package/catalogs/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  58. package/catalogs/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  59. package/catalogs/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  60. package/catalogs/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  61. package/catalogs/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  62. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  63. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  64. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  65. package/catalogs/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  66. package/catalogs/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  67. package/catalogs/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  68. package/catalogs/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  69. package/catalogs/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  70. package/catalogs/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  71. package/catalogs/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  72. package/catalogs/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  73. package/catalogs/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  74. package/catalogs/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  75. package/catalogs/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  76. package/catalogs/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  77. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  78. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  79. package/catalogs/skills/vercel-composition-patterns/AGENTS.md +946 -0
  80. package/catalogs/skills/vercel-composition-patterns/LICENSE.txt +27 -0
  81. package/catalogs/skills/vercel-composition-patterns/README.md +60 -0
  82. package/catalogs/skills/vercel-composition-patterns/SKILL.md +89 -0
  83. package/catalogs/skills/vercel-composition-patterns/metadata.json +11 -0
  84. package/catalogs/skills/vercel-composition-patterns/rules/_sections.md +29 -0
  85. package/catalogs/skills/vercel-composition-patterns/rules/_template.md +24 -0
  86. package/catalogs/skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  87. package/catalogs/skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  88. package/catalogs/skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  89. package/catalogs/skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  90. package/catalogs/skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  91. package/catalogs/skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  92. package/catalogs/skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  93. package/catalogs/skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  94. package/catalogs/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  95. package/catalogs/skills/vercel-react-best-practices/LICENSE.txt +27 -0
  96. package/catalogs/skills/vercel-react-best-practices/README.md +123 -0
  97. package/catalogs/skills/vercel-react-best-practices/SKILL.md +149 -0
  98. package/catalogs/skills/vercel-react-best-practices/metadata.json +15 -0
  99. package/catalogs/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  100. package/catalogs/skills/vercel-react-best-practices/rules/_template.md +28 -0
  101. package/catalogs/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  102. package/catalogs/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  103. package/catalogs/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  104. package/catalogs/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  105. package/catalogs/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  106. package/catalogs/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  107. package/catalogs/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  108. package/catalogs/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  109. package/catalogs/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  110. package/catalogs/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  111. package/catalogs/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  112. package/catalogs/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  113. package/catalogs/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  114. package/catalogs/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  115. package/catalogs/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  116. package/catalogs/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  117. package/catalogs/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  118. package/catalogs/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  119. package/catalogs/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  120. package/catalogs/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  121. package/catalogs/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  122. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  123. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  124. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  125. package/catalogs/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  126. package/catalogs/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  127. package/catalogs/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  128. package/catalogs/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  129. package/catalogs/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  130. package/catalogs/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  131. package/catalogs/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  132. package/catalogs/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  133. package/catalogs/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  134. package/catalogs/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  135. package/catalogs/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  136. package/catalogs/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  137. package/catalogs/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  138. package/catalogs/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  139. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  140. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  141. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  142. package/catalogs/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  143. package/catalogs/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  144. package/catalogs/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  145. package/catalogs/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  146. package/catalogs/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  147. package/catalogs/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  148. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  149. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  150. package/catalogs/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  151. package/catalogs/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  152. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  153. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  154. package/catalogs/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  155. package/catalogs/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  156. package/catalogs/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  157. package/catalogs/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  158. package/catalogs/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  159. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  160. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  161. package/catalogs/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  162. package/catalogs/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  163. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  164. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  165. package/catalogs/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  166. package/catalogs/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  167. package/catalogs/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  168. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  169. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  170. package/catalogs/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  171. package/catalogs/skills/webapp-testing/LICENSE.txt +202 -0
  172. package/catalogs/skills/webapp-testing/SKILL.md +96 -0
  173. package/catalogs/skills/webapp-testing/examples/console_logging.py +35 -0
  174. package/catalogs/skills/webapp-testing/examples/element_discovery.py +40 -0
  175. package/catalogs/skills/webapp-testing/examples/static_html_automation.py +33 -0
  176. package/catalogs/skills/webapp-testing/scripts/with_server.py +106 -0
  177. package/catalogs/skills.json +1115 -0
  178. package/docs/skills/evidencias/2026-10-28-evaluacion-inicial-mcp-seguridad.md +118 -0
  179. package/docs/skills/evidencias/2026-10-28-incorporacion-mcp-seguridad.json +152 -0
  180. package/docs/skills/evidencias/2026-10-28-recomendador-preparacion.md +50 -0
  181. package/package.json +73 -4
  182. package/plugins/nexakit-modelo/.claude-plugin/plugin.json +1 -0
  183. package/plugins/nexakit-modelo/hooks/hooks.json +1 -0
  184. package/plugins/nexakit-modelo/hooks/register.js +48 -0
  185. package/plugins/nexakit-modelo/hooks/status.js +8 -0
  186. package/plugins/nexakit-modelo/tests/register.test.ts +21 -0
  187. package/plugins/nexakit-panel/.claude-plugin/plugin.json +1 -0
  188. package/plugins/nexakit-panel/README.md +20 -0
  189. package/plugins/nexakit-panel/hooks/hooks.json +1 -0
  190. package/plugins/nexakit-panel/hooks/lienzo.js +382 -0
  191. package/plugins/nexakit-panel/hooks/panel.js +279 -0
  192. package/plugins/nexakit-panel/hooks/register.tsx +248 -0
  193. package/plugins/nexakit-panel/tests/lienzo.test.ts +142 -0
  194. package/plugins/nexakit-panel/tests/panel.test.ts +240 -0
  195. package/plugins/nexakit-panel/tests/register.test.ts +167 -0
  196. package/plugins/nexakit-panel/types/index.d.ts +41 -0
  197. package/plugins/nexakit-sesion/.claude-plugin/plugin.json +1 -0
  198. package/plugins/nexakit-sesion/README.md +12 -0
  199. package/plugins/nexakit-sesion/hooks/aviso.js +38 -0
  200. package/plugins/nexakit-sesion/hooks/hooks.json +1 -0
  201. package/plugins/nexakit-sesion/hooks/register.js +28 -0
  202. package/plugins/nexakit-sesion/tests/register.test.ts +96 -0
  203. package/plugins/niveles/.claude-plugin/plugin.json +5 -0
  204. package/plugins/niveles/agents/nivel-alto.md +13 -0
  205. package/plugins/niveles/agents/nivel-exigente.md +13 -0
  206. package/plugins/niveles/agents/nivel-ligero.md +13 -0
  207. package/plugins/niveles/agents/nivel-normal.md +13 -0
  208. package/schemas/agent-client-adapter.schema.json +786 -0
  209. package/schemas/agent-client-auth-diagnostic.schema.json +801 -0
  210. package/schemas/agent-client-isolated-variant.schema.json +105 -0
  211. package/schemas/agent-client-isolated-verification.schema.json +99 -0
  212. package/schemas/agent-client-managed-preferences-invocation.schema.json +67 -0
  213. package/schemas/agent-client-managed-preferences.schema.json +63 -0
  214. package/schemas/agent-client-native-diagnostics.schema.json +85 -0
  215. package/schemas/agent-client-native-evaluation.schema.json +171 -0
  216. package/schemas/agent-client-native-preflight.schema.json +90 -0
  217. package/schemas/agent-client-output.schema.json +551 -0
  218. package/schemas/agent-client-runtime-fixture.schema.json +90 -0
  219. package/schemas/agent-client-runtime-local.schema.json +95 -0
  220. package/schemas/agent-client-runtime.schema.json +1288 -0
  221. package/schemas/agent-client-selective-config.schema.json +77 -0
  222. package/schemas/agent-client-supervised-local.schema.json +135 -0
  223. package/schemas/agent-client-supervised.schema.json +186 -0
  224. package/schemas/agent-model-preference.schema.json +573 -0
  225. package/schemas/agent-model-selection.schema.json +311 -0
  226. package/schemas/agent-task-approvals.schema.json +362 -0
  227. package/schemas/agent-task-prepare.schema.json +1324 -0
  228. package/schemas/agent-task-verify.schema.json +198 -0
  229. package/schemas/project-memory-update.schema.json +33 -0
  230. package/schemas/project-memory.schema.json +298 -0
  231. package/schemas/skill-catalog.schema.json +246 -0
  232. package/schemas/task-workflow-plan-output.schema.json +35 -0
  233. package/scripts/prepare-package.js +6 -0
  234. package/scripts/validate-skill-catalog.js +41 -0
  235. package/skills/cerrar-avisens/SKILL.md +12 -0
  236. package/skills/cerrar-memoria/SKILL.md +96 -0
  237. package/skills/cerrar-memoria/references/cierre.md +76 -0
  238. package/skills/decision-records/SKILL.md +27 -0
  239. package/skills/decision-records/agents/openai.yaml +7 -0
  240. package/skills/decision-records/references/adr-template.md +35 -0
  241. package/skills/differential-review/LICENSE.txt +427 -0
  242. package/skills/differential-review/SKILL.md +225 -0
  243. package/skills/differential-review/adversarial.md +203 -0
  244. package/skills/differential-review/agents/openai.yaml +6 -0
  245. package/skills/differential-review/assets/trail-of-bits-mark.svg +1 -0
  246. package/skills/differential-review/methodology.md +234 -0
  247. package/skills/differential-review/patterns.md +300 -0
  248. package/skills/differential-review/reporting.md +369 -0
  249. package/skills/elegir-modelo/SKILL.md +68 -0
  250. package/skills/elegir-modelo/modelos.mjs +108 -0
  251. package/skills/frontend-design/LICENSE.txt +177 -0
  252. package/skills/frontend-design/SKILL.md +71 -0
  253. package/skills/gemini/SKILL.md +52 -0
  254. package/skills/imagen/SKILL.md +12 -0
  255. package/skills/investigar/SKILL.md +11 -0
  256. package/skills/mcp-builder/LICENSE.txt +202 -0
  257. package/skills/mcp-builder/SKILL.md +236 -0
  258. package/skills/mcp-builder/reference/evaluation.md +602 -0
  259. package/skills/mcp-builder/reference/mcp_best_practices.md +249 -0
  260. package/skills/mcp-builder/reference/node_mcp_server.md +970 -0
  261. package/skills/mcp-builder/reference/python_mcp_server.md +719 -0
  262. package/skills/mcp-builder/scripts/connections.py +151 -0
  263. package/skills/mcp-builder/scripts/evaluation.py +373 -0
  264. package/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
  265. package/skills/mcp-builder/scripts/requirements.txt +2 -0
  266. package/skills/ordenar-proyecto/SKILL.md +56 -0
  267. package/skills/project-handoff/SKILL.md +53 -0
  268. package/skills/project-handoff/agents/openai.yaml +7 -0
  269. package/skills/project-handoff/references/handoff-template.md +35 -0
  270. package/skills/quality-gate/LICENSE.txt +26 -0
  271. package/skills/quality-gate/SKILL.md +44 -0
  272. package/skills/quality-gate/agents/openai.yaml +7 -0
  273. package/skills/quality-gate/references/review-checklist.md +42 -0
  274. package/skills/revisar/SKILL.md +11 -0
  275. package/skills/revisar-skill/LICENSE-find-skills.txt +26 -0
  276. package/skills/revisar-skill/SKILL.md +94 -0
  277. package/skills/revision-cruzada/SKILL.md +59 -0
  278. package/skills/web-design-guidelines/AGENTS.md +156 -0
  279. package/skills/web-design-guidelines/LICENSE.txt +21 -0
  280. package/skills/web-design-guidelines/SKILL.md +29 -0
  281. package/src/agent-models.js +131 -0
  282. package/src/brand.js +117 -0
  283. package/src/claude-code-runner.js +642 -0
  284. package/src/cli-executable.js +88 -0
  285. package/src/cli.js +778 -0
  286. package/src/client-adapter-plan.js +271 -0
  287. package/src/client-auth-diagnostic-parser.js +211 -0
  288. package/src/client-auth-diagnostic.js +257 -0
  289. package/src/client-isolated-variant.js +106 -0
  290. package/src/client-isolated-verification.js +130 -0
  291. package/src/client-local-platform.js +14 -0
  292. package/src/client-managed-preferences-invocation.js +209 -0
  293. package/src/client-managed-preferences.js +78 -0
  294. package/src/client-native-access.js +134 -0
  295. package/src/client-native-diagnostics.js +253 -0
  296. package/src/client-native-evaluation.js +106 -0
  297. package/src/client-native-preflight-files.js +68 -0
  298. package/src/client-native-preflight.js +95 -0
  299. package/src/client-output-json.js +118 -0
  300. package/src/client-output-parser.js +278 -0
  301. package/src/client-runtime-admission.js +80 -0
  302. package/src/client-runtime-coordinator.js +70 -0
  303. package/src/client-runtime-core.js +92 -0
  304. package/src/client-runtime-fixture-permit.js +20 -0
  305. package/src/client-runtime-fixture-protocol.js +39 -0
  306. package/src/client-runtime-state.js +67 -0
  307. package/src/client-runtime-store-files.js +91 -0
  308. package/src/client-runtime-store.js +239 -0
  309. package/src/client-runtime-supervisor.js +146 -0
  310. package/src/client-selective-config.js +195 -0
  311. package/src/client-selective-files.js +126 -0
  312. package/src/client-supervised-codes.js +32 -0
  313. package/src/client-supervised-contract.js +52 -0
  314. package/src/client-supervised-coordinator.js +36 -0
  315. package/src/client-supervised-permit.js +20 -0
  316. package/src/client-supervised-protocol.js +37 -0
  317. package/src/client-supervised-store.js +167 -0
  318. package/src/client-supervised-supervisor.js +167 -0
  319. package/src/client-supervised.js +160 -0
  320. package/src/codex-cli-runner.js +358 -0
  321. package/src/codex-delivery.js +101 -0
  322. package/src/connect.js +703 -0
  323. package/src/doctor.js +795 -0
  324. package/src/gemini-cli.js +76 -0
  325. package/src/gemini-files.js +45 -0
  326. package/src/gemini-tools.js +249 -0
  327. package/src/init.js +473 -0
  328. package/src/install-lock.js +127 -0
  329. package/src/install-registry.js +61 -0
  330. package/src/legacy-repair.js +71 -0
  331. package/src/level-agents.js +111 -0
  332. package/src/link-states.js +172 -0
  333. package/src/memory-connection-artifacts.js +192 -0
  334. package/src/memory-connection-descriptor.js +158 -0
  335. package/src/memory-connection-diagnostic.js +177 -0
  336. package/src/memory-connection-files.js +191 -0
  337. package/src/memory-connection-manifest.js +118 -0
  338. package/src/memory-connection-package.js +176 -0
  339. package/src/memory-connection-plan.js +211 -0
  340. package/src/memory-connection-skill.js +211 -0
  341. package/src/memory-connection-toml.js +153 -0
  342. package/src/memory-locator.js +118 -0
  343. package/src/memory-mcp-policy.js +181 -0
  344. package/src/memory-mcp-server.js +166 -0
  345. package/src/memory-mcp-transport.js +59 -0
  346. package/src/missing-dependencies.js +21 -0
  347. package/src/model-command.js +147 -0
  348. package/src/model-preference.js +235 -0
  349. package/src/model-selection.js +368 -0
  350. package/src/native/managed-preferences.c +100 -0
  351. package/src/native/managed-preferences.h +17 -0
  352. package/src/package-lock-path.js +13 -0
  353. package/src/panel-cli.js +182 -0
  354. package/src/peer-handoff.js +27 -0
  355. package/src/peer-inbox-cli.js +211 -0
  356. package/src/peer-review-mcp.js +210 -0
  357. package/src/peer-review-store.js +532 -0
  358. package/src/platform.js +24 -0
  359. package/src/project-root.js +41 -0
  360. package/src/project-signals.js +339 -0
  361. package/src/recommend-report.js +77 -0
  362. package/src/review-instructions.js +211 -0
  363. package/src/review-policy.js +35 -0
  364. package/src/revision-adapters.js +157 -0
  365. package/src/revision-context.js +86 -0
  366. package/src/revision-isolation.js +222 -0
  367. package/src/revision-process.js +103 -0
  368. package/src/revision-provenance.js +89 -0
  369. package/src/revision-snapshot.js +120 -0
  370. package/src/revision.js +242 -0
  371. package/src/runtime-fixtures/runtime-supervisor/child.cjs +3 -0
  372. package/src/runtime-fixtures/runtime-supervisor/fixture.cjs +49 -0
  373. package/src/runtime-fixtures/supervised/child.cjs +3 -0
  374. package/src/runtime-fixtures/supervised/fixture.cjs +47 -0
  375. package/src/sensitive-data.js +21 -0
  376. package/src/setup-apply.js +231 -0
  377. package/src/setup-plan.js +231 -0
  378. package/src/setup-state.js +277 -0
  379. package/src/setup-tui.js +555 -0
  380. package/src/skill-catalog-add.js +91 -0
  381. package/src/skill-catalog-audit.js +68 -0
  382. package/src/skill-catalog.js +170 -0
  383. package/src/skill-files.js +39 -0
  384. package/src/skill-recommendations.js +1673 -0
  385. package/src/skill-scan-report.js +14 -0
  386. package/src/skill-scan.js +178 -0
  387. package/src/stable-command.js +53 -0
  388. package/src/stable-install.js +222 -0
  389. package/src/status.js +200 -0
  390. package/src/superpowers.js +133 -0
  391. package/src/sync-apply.js +227 -0
  392. package/src/sync-files.js +109 -0
  393. package/src/sync-inspect.js +394 -0
  394. package/src/sync-ledger.js +94 -0
  395. package/src/sync-markdown.js +151 -0
  396. package/src/sync-proposal.js +84 -0
  397. package/src/sync-record.js +459 -0
  398. package/src/sync.js +360 -0
  399. package/src/task-approvals.js +367 -0
  400. package/src/task-cli.js +79 -0
  401. package/src/task-external-verifier.js +584 -0
  402. package/src/task-prepare-files.js +115 -0
  403. package/src/task-prepare.js +180 -0
  404. package/src/task-verify-cli.js +67 -0
  405. package/src/task-verify-files.js +188 -0
  406. package/src/task-verify.js +118 -0
  407. package/src/task-workflow-mcp.js +544 -0
  408. package/src/task-workflow-store.js +254 -0
  409. package/src/terminal-text.js +68 -0
  410. package/src/toolkit-cli.js +543 -0
  411. package/src/toolkit-commands-guide.js +107 -0
  412. package/src/toolkit-setup.js +614 -0
  413. package/src/usage-metrics.js +43 -0
  414. package/templates/agent-team/01-encargo.md +158 -0
  415. package/templates/agent-team/02-propuesta.md +132 -0
  416. package/templates/agent-team/03-revision.md +150 -0
  417. package/templates/agent-team/README.md +213 -0
  418. package/templates/model-inventory/01-inventario.md +154 -0
  419. package/templates/model-inventory/README.md +115 -0
  420. package/templates/project-memory/README.md +67 -0
  421. package/templates/project-memory/project-memory.example.json +53 -0
  422. package/templates/project-memory/skill/project-id/SKILL.md +37 -0
  423. package/templates/project-memory/skill/project-id/references/project-profile.md +44 -0
  424. package/templates/project-memory/vault/00-INICIO/Estado actual.md +44 -0
  425. package/templates/project-memory/vault/00-INICIO/Fuentes de verdad.md +30 -0
  426. package/templates/project-memory/vault/00-INICIO/Inicio del proyecto.md +44 -0
  427. package/templates/project-memory/vault/00-INICIO/Mantenimiento de la memoria.md +26 -0
  428. package/templates/project-memory/vault/00-INICIO/Mapa de la memoria.md +33 -0
  429. package/templates/project-memory/vault/00-INICIO/Registro de sincronizaci/303/263n.md" +28 -0
  430. package/templates/project-memory/vault/01-PRODUCTO/Producto.md +16 -0
  431. package/templates/project-memory/vault/02-ARQUITECTURA/Arquitectura.md +16 -0
  432. package/templates/project-memory/vault/03-IMPLEMENTACION/Implementaci/303/263n.md +15 -0
  433. package/templates/project-memory/vault/04-DECISIONES/Decisiones.md +19 -0
  434. package/templates/project-memory/vault/05-ENTREGAS/Entregas.md +12 -0
  435. package/templates/project-memory/vault/06-OPERACION/Operaci/303/263n.md +15 -0
  436. package/templates/project-memory/vault/07-AGENTES/Protocolo de agentes.md +33 -0
  437. package/templates/project-memory/vault/08-RECURSOS/Recursos.md +12 -0
  438. package/templates/project-memory/vault/09-ARCHIVO/README.md +5 -0
@@ -0,0 +1,257 @@
1
+ import { supportsAuthHost } from "./client-local-platform.js";
2
+ import fs from "node:fs/promises";
3
+ import { constants } from "node:fs";
4
+ import path from "node:path";
5
+ import { spawn as systemSpawn } from "node:child_process";
6
+ import { createHash } from "node:crypto";
7
+ import { types } from "node:util";
8
+ import Ajv2020 from "ajv/dist/2020.js";
9
+ import { copyInertJson, copyBytes } from "./client-output-json.js";
10
+ import { hash } from "./client-runtime-core.js";
11
+ import { createStoreFiles } from "./client-runtime-store-files.js";
12
+ import { createAuthDiagnosticParser, AUTH_DIAGNOSTIC_ID } from "./client-auth-diagnostic-parser.js";
13
+
14
+ const SCHEMA_ID = AUTH_DIAGNOSTIC_ID;
15
+ const permits = new WeakMap(), monotonic = () => Number(process.hrtime.bigint() / 1000000n);
16
+ const environmentIdentity = () => hash({ home: process.env.HOME, uid: process.getuid?.() ?? null, profile: "auth-status-minimal-v1" });
17
+ const physicalName = p => typeof p === "string" && path.isAbsolute(p) && path.normalize(p) === p &&
18
+ !/[\x00-\x1f\x7f]/.test(p) && Buffer.from(p, "utf8").toString("utf8") === p;
19
+ const signature = s => JSON.stringify([s.dev, s.ino, s.uid, s.mode, s.nlink, s.size, s.mtimeMs, s.ctimeMs]);
20
+ const chunkLength = b => {
21
+ if (types.isProxy(b) || !types.isUint8Array(b)) throw Error("chunk");
22
+ return Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), "length").get.call(b);
23
+ };
24
+
25
+ /** Trusted orchestration must obtain human approval first. JSON/hash is not consent. */
26
+ export function createAuthDiagnosticPermit(schema, configuration) {
27
+ let cfg;
28
+ try {
29
+ cfg = copyInertJson(configuration);
30
+ validateConfiguration(schema, cfg);
31
+ } catch { throw Error("Invalid auth diagnostic permission configuration"); }
32
+ const handle = Object.freeze(Object.create(null)), issuedAt = monotonic();
33
+ permits.set(handle, { binding: hash(cfg), environment: environmentIdentity(), issuedAt, expiresAt: issuedAt + cfg.limits.permitLifetimeMs, live: true, used: false });
34
+ return handle;
35
+ }
36
+ export function revokeAuthDiagnosticPermit(handle) {
37
+ if (types.isProxy(handle)) return;
38
+ const p = permits.get(handle); if (p) p.live = false;
39
+ }
40
+
41
+ async function verifyArtifact(cfg, io, files, deadline, now) {
42
+ const pin = cfg.artifact, link = cfg.entryLink;
43
+ const verifyLink = async () => {
44
+ await files.physical(path.dirname(link.path));
45
+ const s = await io.lstat(link.path);
46
+ if (!s.isSymbolicLink() || s.dev !== link.dev || s.ino !== link.ino || s.uid !== link.uid ||
47
+ (s.mode & 4095) !== link.mode || s.size !== link.size || s.mtimeMs !== link.mtimeMs || s.ctimeMs !== link.ctimeMs ||
48
+ path.resolve(path.dirname(link.path), await io.readlink(link.path)) !== pin.path) throw Error("link");
49
+ };
50
+ await verifyLink();
51
+ await files.physical(pin.path);
52
+ const before = await io.lstat(pin.path);
53
+ if (!before.isFile() || before.isSymbolicLink() || before.nlink !== 1 || before.dev !== pin.dev || before.ino !== pin.ino ||
54
+ before.uid !== pin.uid || (before.mode & 4095) !== pin.mode || !(pin.mode & 0o100) || pin.mode & 0o7022 || before.size !== pin.size ||
55
+ before.mtimeMs !== pin.mtimeMs || before.ctimeMs !== pin.ctimeMs) throw Error("artifact");
56
+ const handle = await io.open(pin.path, constants.O_RDONLY | constants.O_NOFOLLOW), digest = createHash("sha256");
57
+ try {
58
+ if (signature(before) !== signature(await handle.stat())) throw Error("artifact");
59
+ const buffer = Buffer.alloc(65536); let offset = 0;
60
+ while (offset < pin.size) {
61
+ if (now() >= deadline) throw Error("deadline");
62
+ const length = Math.min(buffer.length, pin.size - offset, 536870912 - offset);
63
+ const { bytesRead } = await handle.read(buffer, 0, length, offset); if (!bytesRead) throw Error("artifact");
64
+ offset += bytesRead; if (offset > pin.size || offset > 536870912) throw Error("artifact"); digest.update(buffer.subarray(0, bytesRead));
65
+ }
66
+ if (offset !== pin.size || digest.digest("hex") !== pin.sha256 || signature(before) !== signature(await handle.stat()) ||
67
+ signature(before) !== signature(await io.lstat(pin.path))) throw Error("artifact");
68
+ await files.physical(pin.path); await verifyLink();
69
+ } finally { await handle.close(); }
70
+ }
71
+
72
+ /** Hash binding for a trusted review; computing it is NOT evidence of safe startup. */
73
+ export function authDiagnosticReviewBinding(configuration) {
74
+ const c = copyInertJson(configuration);
75
+ return hash({ source: c.source, recipe: c.recipe, version: c.version, artifact: c.artifact, entryLink: c.entryLink,
76
+ workspaceParent: c.workspaceParent, excludedRoots: c.excludedRoots, environment: environmentIdentity() });
77
+ }
78
+ function validateConfiguration(schema, cfg) {
79
+ const s = copyInertJson(schema);
80
+ if (s.$id !== SCHEMA_ID) throw Error();
81
+ const ajv = new Ajv2020({ strict: true, allErrors: true }); ajv.addSchema(s);
82
+ if (!ajv.compile({ $ref: SCHEMA_ID + "#/$defs/configuration" })(cfg) ||
83
+ ![cfg.artifact.path, cfg.entryLink.path, cfg.workspaceParent.path, ...cfg.excludedRoots].every(physicalName) ||
84
+ cfg.artifact.path === cfg.entryLink.path || cfg.workspaceParent.path === path.parse(cfg.workspaceParent.path).root ||
85
+ cfg.limits.graceMs + cfg.limits.confirmationMs + 20 >= cfg.limits.processTimeoutMs ||
86
+ cfg.limits.processTimeoutMs > cfg.limits.totalTimeoutMs) throw Error();
87
+ return { schema: s, validReport: ajv.compile({ $ref: SCHEMA_ID + "#/$defs/report" }) };
88
+ }
89
+ function reviewed(cfg) {
90
+ const b = authDiagnosticReviewBinding(cfg);
91
+ return cfg.identityReview.state === "reviewed" && cfg.identityReview.bindingSha256 === b &&
92
+ cfg.startupReview.state === "reviewed" && cfg.startupReview.bindingSha256 === b &&
93
+ cfg.startupReview.effectsEnumerated && !cfg.startupReview.unresolvedEffects;
94
+ }
95
+
96
+ /** Only trusted orchestration may supply assessment/consent/dependencies. No model JSON is proof. */
97
+ export function createAuthDiagnosticCollector(schema, configuration, authorization, dependencies = {}) {
98
+ let cfg, validReport, parserSchema;
99
+ try {
100
+ cfg = copyInertJson(configuration);
101
+ const validated = validateConfiguration(schema, cfg);
102
+ parserSchema = validated.schema; validReport = validated.validReport;
103
+ createAuthDiagnosticParser(parserSchema, { maxBytes: cfg.limits.maxOutputBytes, blockBytes: cfg.limits.maxOutputBytes,
104
+ maxDepth: 32, maxNodes: 20000, maxKeyBytes: 256, maxKeys: 4096 });
105
+ } catch { throw Error("Invalid auth diagnostic configuration"); }
106
+ const limits = cfg.limits, io = { ...fs, ...dependencies.io }, files = createStoreFiles(dependencies.io);
107
+ const spawn = dependencies.spawn ?? systemSpawn, kill = dependencies.kill ?? process.kill.bind(process), now = dependencies.monotonic ?? monotonic;
108
+ let invoked = false;
109
+ return Object.freeze({ async run(...args) {
110
+ const began = now(), deadline = began + limits.totalTimeoutMs;
111
+ const r = { scope: "auth-status-only", source: cfg.source, state: "blocked-before-start", spawnAttempts: 0,
112
+ processStarted: false, nativeExecuted: false, artifactMatchedBefore: false, artifactMatchedAfter: false,
113
+ terminationConfirmed: true, cleanupRequired: false, stdoutBytes: 0, stderrBytes: 0, elapsedMs: 0, projection: null, reasons: [],
114
+ inferenceRequested: false, runtimeReady: false, verifiedAdmission: false,
115
+ externalBillingVerified: false, remoteCancellationVerified: false, actualModelCalls: null };
116
+ let workspace, owned, parent, permission, claimed = false;
117
+ const add = code => { if (!r.reasons.includes(code)) r.reasons.push(code); };
118
+ try {
119
+ if (invoked) throw Error("permission"); invoked = true;
120
+ permission = !types.isProxy(authorization) && permits.get(authorization);
121
+ if (!permission || !permission.live || permission.used || permission.binding !== hash(cfg) ||
122
+ permission.environment !== environmentIdentity() ||
123
+ began < permission.issuedAt || began >= permission.expiresAt) { add("auth-permission-rejected"); return r; }
124
+ permission.used = true; claimed = true;
125
+ if (args.length) { add("auth-input-forbidden"); return r; }
126
+ if (!reviewed(cfg)) { add("auth-startup-not-reviewed"); return r; }
127
+ if (!supportsAuthHost(process.platform, cfg.source) || cfg.artifact.uid !== process.getuid() || cfg.workspaceParent.uid !== process.getuid()) throw Error("identity");
128
+ if (dependencies.signal?.aborted) { r.state = "canceled"; add("auth-canceled"); return r; }
129
+ const home = process.env.HOME;
130
+ if (!physicalName(home) || cfg.workspaceParent.path === home || /(CloudStorage|Mobile Documents|Dropbox|OneDrive|iCloud|Obsidian)/i.test(cfg.workspaceParent.path) ||
131
+ cfg.excludedRoots.some(root => cfg.workspaceParent.path === root || cfg.workspaceParent.path.startsWith(root + path.sep))) throw Error("parent");
132
+ parent = await files.directory(cfg.workspaceParent.path);
133
+ if (parent.dev !== cfg.workspaceParent.dev || parent.ino !== cfg.workspaceParent.ino || parent.uid !== cfg.workspaceParent.uid ||
134
+ (parent.mode & 4095) !== cfg.workspaceParent.mode) throw Error("parent");
135
+ for (let dir = cfg.workspaceParent.path; ; dir = path.dirname(dir)) {
136
+ for (const marker of [".git", ".obsidian"]) {
137
+ try { await io.lstat(path.join(dir, marker)); throw Error("project"); } catch (e) { if (e.code !== "ENOENT") throw e; }
138
+ }
139
+ if (dir === path.parse(dir).root) break;
140
+ }
141
+ await verifyArtifact(cfg, io, files, deadline, now); r.artifactMatchedBefore = true;
142
+ workspace = await io.mkdtemp(path.join(cfg.workspaceParent.path, "auth-work-")); await io.chmod(workspace, 0o700); owned = await files.directory(workspace);
143
+ const stream = createAuthDiagnosticParser(parserSchema, { maxBytes: limits.maxOutputBytes, blockBytes: limits.maxOutputBytes,
144
+ maxDepth: 32, maxNodes: 20000, maxKeyBytes: 256, maxKeys: 4096 });
145
+ if (!permission.live || dependencies.signal?.aborted || environmentIdentity() !== permission.environment ||
146
+ now() >= Math.min(deadline, permission.expiresAt) - limits.graceMs - limits.confirmationMs) throw Error("pre-start");
147
+ const processDeadline = Math.min(deadline, now() + limits.processTimeoutMs);
148
+ const env = { HOME: home, TMPDIR: workspace, PATH: "/usr/bin:/bin", LANG: "C", LC_ALL: "C" };
149
+ r.spawnAttempts = 1; r.terminationConfirmed = false;
150
+ let child;
151
+ try { child = spawn(cfg.entryLink.path, ["auth", "status"], { shell: false, detached: true, cwd: workspace, env, stdio: ["ignore", "pipe", "pipe"] }); }
152
+ catch { r.terminationConfirmed = true; add("auth-spawn-failed"); throw Error("spawn"); }
153
+ await new Promise(resolve => {
154
+ let done = false, stopped = false, stoppedAt = null, forced = false, gone = false, failedSpawn = false, pid = null;
155
+ let exited = false, closed = false, outClosed = false, errClosed = false, exitCode = null, timer, hard;
156
+ const send = signal => {
157
+ if (pid === null || gone) return;
158
+ try { kill(-pid, signal); } catch (e) { if (e.code === "ESRCH") gone = true; else add("auth-signal-unconfirmed"); }
159
+ };
160
+ const alive = () => {
161
+ if (gone || failedSpawn) return false;
162
+ if (pid === null) return true;
163
+ try { kill(-pid, 0); return true; } catch (e) { if (e.code === "ESRCH") { gone = true; return false; } add("auth-group-unconfirmed"); return true; }
164
+ };
165
+ const stop = (code, state = "failed") => {
166
+ if (done) return; add(code);
167
+ if (stopped) return;
168
+ stopped = true; stoppedAt = now(); r.state = state; stream.abort(); send("SIGTERM");
169
+ };
170
+ const finish = uncertain => {
171
+ if (done) return; done = true; clearInterval(timer); clearTimeout(hard); dependencies.signal?.removeEventListener("abort", abort);
172
+ r.terminationConfirmed = failedSpawn || exited && closed && outClosed && errClosed && gone;
173
+ if (uncertain || !r.terminationConfirmed || now() > deadline) { r.state = "indeterminate"; add("auth-termination-unconfirmed"); stream.abort(); }
174
+ else if (failedSpawn) r.state = "failed";
175
+ else if (!stopped) {
176
+ const projection = stream.finish(exitCode);
177
+ if (projection.state === "invalid") { r.state = "failed"; add("auth-protocol-invalid"); }
178
+ else { r.projection = projection.projection; r.state = "observation-complete"; }
179
+ }
180
+ if (stopped || uncertain || failedSpawn) stream.finish(null);
181
+ child.stdout.destroy(); child.stderr.destroy(); resolve();
182
+ };
183
+ const poll = () => {
184
+ if (done) return;
185
+ if (!permission.live || now() >= permission.expiresAt) stop("auth-permission-revoked", "canceled");
186
+ if (now() >= processDeadline - limits.graceMs - limits.confirmationMs && !stopped) stop("auth-deadline", "timed-out");
187
+ if (stopped && !forced && now() - stoppedAt >= limits.graceMs) { forced = true; send("SIGKILL"); }
188
+ const live = alive();
189
+ if (exited && closed && outClosed && errClosed && !live) finish(false);
190
+ else if (exited && live && !stopped) stop("auth-descendants-unconfirmed");
191
+ if (failedSpawn && closed) finish(false);
192
+ if (!done && stopped && forced && now() - stoppedAt >= limits.graceMs + limits.confirmationMs) finish(true);
193
+ };
194
+ const abort = () => stop("auth-canceled", "canceled");
195
+ child.on("spawn", () => {
196
+ if (done) {
197
+ // A late transport callback cannot mutate an already returned report.
198
+ if (!gone && Number.isSafeInteger(child.pid) && child.pid > 1) {
199
+ // Best effort only: no new reason or termination claim after delivery.
200
+ try { kill(-child.pid, "SIGKILL"); } catch { /* Keep the delivered uncertainty intact. */ }
201
+ }
202
+ return;
203
+ }
204
+ r.processStarted = true; r.nativeExecuted = cfg.source === "native-client-declaration";
205
+ if (!Number.isSafeInteger(child.pid) || child.pid <= 1) { stop("auth-pid-unavailable"); return; }
206
+ pid = child.pid;
207
+ if (stopped) send("SIGTERM");
208
+ });
209
+ child.on("error", () => { if (done) return; if (!r.processStarted) { failedSpawn = true; add("auth-spawn-failed"); } else stop("auth-process-error"); });
210
+ child.on("exit", code => { exited = true; exitCode = code; poll(); }); child.on("close", () => { closed = true; poll(); });
211
+ child.stdout.on("close", () => { outClosed = true; poll(); }); child.stderr.on("close", () => { errClosed = true; poll(); });
212
+ child.stdout.on("error", () => stop("auth-stream-error")); child.stderr.on("error", () => stop("auth-stream-error"));
213
+ child.stdout.on("data", chunk => {
214
+ if (done || stopped) return;
215
+ try {
216
+ r.stdoutBytes += chunkLength(chunk);
217
+ if (r.stdoutBytes > limits.maxOutputBytes) stop("auth-output-limit");
218
+ else if (stream.push(copyBytes(chunk, limits.maxOutputBytes)).state === "invalid") stop("auth-output-invalid");
219
+ } catch { stop("auth-output-invalid"); }
220
+ });
221
+ child.stderr.on("data", chunk => {
222
+ if (done || stopped) return;
223
+ try { const size = chunkLength(chunk); r.stderrBytes += size; if (size) stop(r.stderrBytes > limits.maxErrorBytes ? "auth-stderr-limit" : "auth-stderr-not-empty"); }
224
+ catch { stop("auth-stderr-invalid"); }
225
+ });
226
+ dependencies.signal?.addEventListener("abort", abort, { once: true }); if (dependencies.signal?.aborted) abort();
227
+ timer = setInterval(poll, 10);
228
+ hard = setTimeout(() => { send("SIGKILL"); poll(); if (!done) finish(true); }, Math.max(1, deadline - now()));
229
+ });
230
+ if (r.state === "observation-complete") {
231
+ await verifyArtifact(cfg, io, files, deadline, now); r.artifactMatchedAfter = true;
232
+ if (!permission.live || dependencies.signal?.aborted || now() >= permission.expiresAt ||
233
+ environmentIdentity() !== permission.environment) throw Error("revoked");
234
+ }
235
+ } catch {
236
+ r.state = r.processStarted ? "indeterminate" : r.spawnAttempts ? "failed" : "blocked-before-start";
237
+ r.projection = null; add("auth-local-check-failed");
238
+ } finally {
239
+ if (workspace) {
240
+ if (r.terminationConfirmed && owned) try { await files.directory(cfg.workspaceParent.path, parent); await files.directory(workspace, owned); await io.rmdir(workspace); }
241
+ catch { r.state = "indeterminate"; r.cleanupRequired = true; add("auth-workspace-cleanup-required"); }
242
+ else { r.cleanupRequired = true; add("auth-workspace-retained"); }
243
+ }
244
+ r.elapsedMs = Math.max(0, Math.ceil(now() - began));
245
+ if (claimed && r.state === "observation-complete" && (!permission.live || dependencies.signal?.aborted ||
246
+ now() >= permission.expiresAt || environmentIdentity() !== permission.environment)) {
247
+ r.state = "canceled"; add("auth-permission-revoked");
248
+ }
249
+ if (claimed) revokeAuthDiagnosticPermit(authorization);
250
+ if (r.elapsedMs > limits.totalTimeoutMs) { r.state = "indeterminate"; add("auth-deadline"); }
251
+ if (r.state !== "observation-complete") r.projection = null;
252
+ if (!r.reasons.length) add(r.state === "observation-complete" ? "auth-observation-complete" : "auth-failed");
253
+ r.reasons.sort(); if (!validReport(r)) throw Error("Auth diagnostic report invariant failed");
254
+ }
255
+ return r;
256
+ } });
257
+ }
@@ -0,0 +1,106 @@
1
+ import Ajv2020 from "ajv/dist/2020.js";
2
+ import { types } from "node:util";
3
+ import { copyInertJson, copyBytes, decode, parseEventJson, fail } from "./client-output-json.js";
4
+ import { hash } from "./client-runtime-core.js";
5
+
6
+ export const ISOLATED_VARIANT_ID = "claude-subscription-text-v1";
7
+ export const ISOLATED_SCHEMA_ID = "https://agent-toolkit.local/schemas/agent-client-isolated-variant.schema.json";
8
+ // Semantic constraints, deliberately not flags, settings, commands or guarantees.
9
+ export const ISOLATED_MECHANISMS = Object.freeze([
10
+ ["tools-empty-denied", "empty-tools-and-total-denial"],
11
+ ["restricted-settings", "restricted-session-and-limited-setting-sources"],
12
+ ["local-personalizations-excluded", "local-personalizations-excluded-without-editing"],
13
+ ["session-hooks-disabled", "session-hook-exclusion-not-managed-hook-proof"],
14
+ ["managed-sources-excluded", "managed-and-host-sources-require-separate-proof"],
15
+ ["strict-empty-mcp", "strict-owned-empty-mcp-with-managed-conflict-check"],
16
+ ["connectors-disabled", "cloud-connector-discovery-excluded"],
17
+ ["browser-ide-excluded", "browser-and-ide-not-enabled"],
18
+ ["skills-plugins-delegation-excluded", "skills-plugins-and-delegation-excluded"],
19
+ ["minimal-environment", "explicit-minimal-environment-without-api-or-helper"],
20
+ ["updates-nonessential-traffic-disabled", "updates-and-nonessential-traffic-excluded"],
21
+ ["resume-persistence-fallback-excluded", "no-resume-persistence-or-requested-fallback"]
22
+ ].map(([id, constraint]) => Object.freeze({ id, constraint, definitionSha256: hash({ id, constraint, revision: 1 }) })));
23
+ const ids = ISOLATED_MECHANISMS.map(m => m.id);
24
+ const definitions = new Map(ISOLATED_MECHANISMS.map(m => [m.id, m.definitionSha256]));
25
+ const basis = Object.freeze({ documented: "documentation", "local-structure-observation": "structure", "operator-attested": "attestation", "native-variant-tested": "native-test" });
26
+ const utc = v => typeof v === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/.test(v) && Number.isFinite(Date.parse(v)) && new Date(v).toISOString() === v.replace(/Z$/, ".000Z");
27
+
28
+ function strictJson(input) {
29
+ if (types.isProxy(input)) fail("isolated-invalid-input");
30
+ const d = typeof input === "string" || types.isUint8Array(input)
31
+ ? parseEventJson(decode(copyBytes(input, 32768))) : copyInertJson(input);
32
+ return copyInertJson(parseEventJson(decode(copyBytes(JSON.stringify(d), 32768))));
33
+ }
34
+ const sortById = values => [...values].sort((a, b) => a.mechanismId < b.mechanismId ? -1 : a.mechanismId > b.mechanismId ? 1 : 0);
35
+
36
+ /** Checks consistency of unverified declarations; cannot issue a native permit. */
37
+ export function createIsolatedVariantEvaluator(schema, trustedPolicy) {
38
+ let validators, policy;
39
+ try {
40
+ const s = copyInertJson(schema);
41
+ if (s.$id !== ISOLATED_SCHEMA_ID || hash(s.$defs.mechanismId.enum) !== hash(ids)) throw Error();
42
+ const ajv = new Ajv2020({ strict: true, allErrors: true });
43
+ ajv.addFormat("date-time", { type: "string", validate: utc }); ajv.addSchema(s);
44
+ validators = Object.fromEntries(["input", "policy", "report"].map(n => [n, ajv.compile({ $ref: `${ISOLATED_SCHEMA_ID}#/$defs/${n}` })]));
45
+ policy = strictJson(trustedPolicy);
46
+ if (!validators.policy(policy)) throw Error();
47
+ } catch { throw Error("Invalid isolated-variant schema or policy"); }
48
+ const revoked = new Set(policy.revokedReferences);
49
+ const normalizedPolicy = { ...policy, revokedReferences: [...policy.revokedReferences].sort(), allowedVariants: [...policy.allowedVariants].sort() };
50
+ return input => {
51
+ const r = { scope: "isolated-variant-claims-only", state: "invalid", reasons: [], unresolvedMechanisms: [],
52
+ descriptionSha256: null, scopeSha256: null, executed: false, runtimeReady: false, verifiedAdmission: false,
53
+ externalBillingVerified: false, effectiveIsolationVerified: false };
54
+ try {
55
+ const d = strictJson(input);
56
+ if (!validators.input(d)) fail("isolated-invalid-input");
57
+ const blocked = new Set(), missing = new Set(), unresolved = new Set();
58
+ const description = { schemaVersion: d.schemaVersion, variantId: d.variantId, candidate: d.candidate,
59
+ mode: d.mode, role: d.role, mechanisms: [...d.mechanisms].sort(), observations: sortById(d.observations) };
60
+ r.descriptionSha256 = hash(description);
61
+ r.scopeSha256 = hash({ description, policy: normalizedPolicy, definitions: ISOLATED_MECHANISMS });
62
+ if (!policy.allowedVariants.includes(d.variantId)) blocked.add("isolated-variant-not-allowed");
63
+ if (["api", "bare"].includes(d.candidate.authentication)) blocked.add("isolated-authentication-incompatible");
64
+ if (d.candidate.authentication === "unknown") missing.add("isolated-authentication-unresolved");
65
+ const unique = (values, key) => {
66
+ if (new Set(values.map(key)).size !== values.length) blocked.add("isolated-duplicate-mechanism");
67
+ };
68
+ unique(d.mechanisms, v => v); unique(d.observations, v => v.mechanismId); unique(d.assessments, v => v.mechanismId);
69
+ const fresh = (time, ref) => {
70
+ if (revoked.has(ref)) { blocked.add("isolated-evidence-revoked"); return false; }
71
+ const age = Date.parse(d.now) - Date.parse(time);
72
+ if (age < 0) { blocked.add("isolated-evidence-future"); return false; }
73
+ if (age > policy.maxEvidenceAgeSeconds * 1000) { blocked.add("isolated-evidence-expired"); return false; }
74
+ return true;
75
+ };
76
+ for (const id of ids) {
77
+ if (!d.mechanisms.includes(id)) { missing.add("isolated-mechanism-missing"); unresolved.add(id); }
78
+ const o = d.observations.find(v => v.mechanismId === id);
79
+ if (!o) { missing.add("isolated-observation-missing"); unresolved.add(id); }
80
+ else if (!fresh(o.observedAt, o.referenceId) || o.state === "unknown") {
81
+ missing.add("isolated-observation-unresolved"); unresolved.add(id);
82
+ }
83
+ const a = d.assessments.find(v => v.mechanismId === id);
84
+ if (!a || a.provenance === "pending") { missing.add("isolated-assessment-missing"); unresolved.add(id); continue; }
85
+ const current = fresh(a.observedAt, a.referenceId);
86
+ if (a.scopeSha256 !== r.scopeSha256 || a.definitionSha256 !== definitions.get(id)) {
87
+ blocked.add("isolated-evidence-binding-mismatch"); unresolved.add(id);
88
+ }
89
+ if (a.provenance === "rejected" || a.outcome === "incompatible") { blocked.add("isolated-mechanism-incompatible"); unresolved.add(id); }
90
+ if (a.provenance !== "rejected" && a.basis !== basis[a.provenance]) { blocked.add("isolated-provenance-mismatch"); unresolved.add(id); }
91
+ if (!current || a.provenance !== "native-variant-tested" || a.basis !== "native-test" || a.outcome !== "supported") {
92
+ missing.add("isolated-effectiveness-unresolved"); unresolved.add(id);
93
+ }
94
+ }
95
+ r.state = blocked.size ? "blocked" : missing.size ? "incomplete" : "ready-for-variant-review";
96
+ r.reasons = [...new Set([...blocked, ...missing])].sort();
97
+ if (!r.reasons.length) r.reasons = ["isolated-claims-ready-for-review"];
98
+ r.unresolvedMechanisms = [...unresolved].sort();
99
+ } catch {
100
+ r.state = "invalid"; r.reasons = ["isolated-invalid-input"]; r.unresolvedMechanisms = [];
101
+ r.descriptionSha256 = null; r.scopeSha256 = null;
102
+ }
103
+ if (!validators.report(r)) throw Error("Isolated-variant report invariant failed");
104
+ return r;
105
+ };
106
+ }
@@ -0,0 +1,130 @@
1
+ import Ajv2020 from "ajv/dist/2020.js";
2
+ import { types } from "node:util";
3
+ import { copyInertJson, copyBytes, decode, parseEventJson, fail } from "./client-output-json.js";
4
+ import { hash } from "./client-runtime-core.js";
5
+ import { createIsolatedVariantEvaluator, ISOLATED_MECHANISMS, ISOLATED_SCHEMA_ID } from "./client-isolated-variant.js";
6
+
7
+ export const VERIFICATION_SCHEMA_ID = "https://agent-toolkit.local/schemas/agent-client-isolated-verification.schema.json";
8
+ const phases = Object.freeze(["pre-start", "session", "shutdown"]);
9
+ const coverage = [
10
+ ["session"], ["pre-start", "session"], ["pre-start"], phases, phases,
11
+ ["pre-start", "session"], ["pre-start", "session"], ["pre-start", "session"], phases,
12
+ ["pre-start"], phases, phases
13
+ ];
14
+ // Closed semantic methods, not executable recipes or authenticated capabilities.
15
+ export const ISOLATED_VERIFICATION_CHECKS = Object.freeze(ISOLATED_MECHANISMS.map((m, i) => Object.freeze({
16
+ mechanismId: m.id, definitionSha256: m.definitionSha256,
17
+ allowedMethods: Object.freeze(["documentation-review", ...(m.id === "tools-empty-denied" ? [] : ["structure-review"]),
18
+ ...(m.id === "managed-sources-excluded" ? [] : ["fixture-test"]), "native-test"]),
19
+ requiredCoverage: Object.freeze([...coverage[i]])
20
+ })));
21
+ const provenanceBasis = Object.freeze({ documented: "documentation", "local-structure-observation": "structure",
22
+ "operator-attested": "attestation", "fixture-claim": "fixture-test", "native-claim": "native-test" });
23
+ const methodBasis = Object.freeze({ "documentation-review": "documentation", "structure-review": "structure", "fixture-test": "fixture-test", "native-test": "native-test" });
24
+ const utc = v => typeof v === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/.test(v) && Number.isFinite(Date.parse(v)) && new Date(v).toISOString() === v.replace(/Z$/, ".000Z");
25
+ const byId = values => [...values].sort((a, b) => a.mechanismId < b.mechanismId ? -1 : a.mechanismId > b.mechanismId ? 1 : 0);
26
+ function strictJson(input) {
27
+ if (types.isProxy(input)) fail("verification-invalid-input");
28
+ const d = typeof input === "string" || types.isUint8Array(input)
29
+ ? parseEventJson(decode(copyBytes(input, 32768))) : copyInertJson(input);
30
+ return copyInertJson(parseEventJson(decode(copyBytes(JSON.stringify(d), 32768))));
31
+ }
32
+ const emptyRow = c => ({ mechanismId: c.mechanismId, methodId: null, state: "unresolved",
33
+ requiredCoverage: [...c.requiredCoverage], missingCoverage: [...c.requiredCoverage],
34
+ missingEvidence: ["planning-check", "native-effectiveness-evidence", "trusted-provenance"], reasons: [], evidenceAuthenticated: false });
35
+
36
+ /** Pure planning. Even a complete plan cannot authorize or authenticate a native run. */
37
+ export function createIsolatedVerificationPlanner(schema, trustedCatalog) {
38
+ let valid, catalog, evaluateVariant;
39
+ try {
40
+ const s = copyInertJson(schema); catalog = strictJson(trustedCatalog);
41
+ if (s.$id !== VERIFICATION_SCHEMA_ID || catalog.variantSchema?.$id !== ISOLATED_SCHEMA_ID) throw Error();
42
+ evaluateVariant = createIsolatedVariantEvaluator(catalog.variantSchema, catalog.variantPolicy);
43
+ const ajv = new Ajv2020({ strict: true, allErrors: true }); ajv.addFormat("date-time", { type: "string", validate: utc });
44
+ ajv.addSchema(catalog.variantSchema); ajv.addSchema(s);
45
+ valid = Object.fromEntries(["input", "catalog", "report"].map(n => [n, ajv.compile({ $ref: `${VERIFICATION_SCHEMA_ID}#/$defs/${n}` })]));
46
+ if (!valid.catalog(catalog)) throw Error();
47
+ const normalized = byId(catalog.checks).map(c => ({ ...c, allowedMethods: [...c.allowedMethods].sort(), requiredCoverage: [...c.requiredCoverage].sort() }));
48
+ const expected = byId(ISOLATED_VERIFICATION_CHECKS).map(c => ({ ...c, allowedMethods: [...c.allowedMethods].sort(), requiredCoverage: [...c.requiredCoverage].sort() }));
49
+ if (hash(normalized) !== hash(expected)) throw Error();
50
+ } catch { throw Error("Invalid isolated-verification schema or catalog"); }
51
+ const revoked = new Set(catalog.variantPolicy.revokedReferences);
52
+ const catalogSha256 = hash({ catalogId: catalog.catalogId, checks: ISOLATED_VERIFICATION_CHECKS, variantSchema: catalog.variantSchema });
53
+ return input => {
54
+ const r = { scope: "isolated-verification-plan-only", state: "invalid", decision: "no-native-start",
55
+ matrix: ISOLATED_VERIFICATION_CHECKS.map(emptyRow), reasons: [], planSha256: null, variantScopeSha256: null,
56
+ executed: false, runtimeReady: false, verifiedAdmission: false, externalBillingVerified: false, effectiveIsolationVerified: false };
57
+ try {
58
+ const d = strictJson(input); if (!valid.input(d)) fail("verification-invalid-input");
59
+ const v = evaluateVariant(d.variant); if (v.state === "invalid") fail("verification-invalid-input");
60
+ r.variantScopeSha256 = v.scopeSha256;
61
+ r.planSha256 = hash({ variantScopeSha256: v.scopeSha256, catalogSha256,
62
+ checks: byId(d.checks).map(c => ({ mechanismId: c.mechanismId, methodId: c.methodId, coverage: [...c.coverage].sort(), containment: c.containment })) });
63
+ const blocked = new Set(), reasons = new Set();
64
+ if (v.state === "blocked") blocked.add("verification-variant-blocked");
65
+ if (v.state === "incomplete") reasons.add("verification-variant-evidence-unresolved");
66
+ if (d.variant.candidate.authentication === "unknown") blocked.add("verification-authentication-unresolved");
67
+ if (new Set(d.checks.map(c => c.mechanismId)).size !== d.checks.length) blocked.add("verification-duplicate-check");
68
+ for (let i = 0; i < r.matrix.length; i++) {
69
+ const row = r.matrix[i], template = ISOLATED_VERIFICATION_CHECKS[i];
70
+ const c = d.checks.find(x => x.mechanismId === row.mechanismId), rowBlocked = new Set(), rowReasons = new Set();
71
+ const observation = d.variant.observations.find(o => o.mechanismId === row.mechanismId);
72
+ if (!d.variant.mechanisms.includes(row.mechanismId)) {
73
+ rowBlocked.add("verification-variant-mechanism-missing"); row.missingEvidence.push("variant-mechanism-selection");
74
+ }
75
+ if (!observation || observation.state === "unknown") {
76
+ rowReasons.add("verification-variant-observation-unresolved"); row.missingEvidence.push("variant-structural-reference");
77
+ }
78
+ if (row.mechanismId === "managed-sources-excluded" && (!observation || observation.state === "unknown")) {
79
+ rowBlocked.add("verification-managed-policy-unresolved"); row.missingEvidence.push("effective-managed-policy");
80
+ }
81
+ if (!c) rowBlocked.add("verification-check-missing");
82
+ else {
83
+ row.methodId = c.methodId; row.missingEvidence = row.missingEvidence.filter(x => x !== "planning-check");
84
+ row.missingCoverage = template.requiredCoverage.filter(p => !c.coverage.includes(p));
85
+ if (!template.allowedMethods.includes(c.methodId)) rowBlocked.add("verification-method-not-allowed");
86
+ if (new Set(c.coverage).size !== c.coverage.length) rowBlocked.add("verification-duplicate-coverage");
87
+ if (row.missingCoverage.length || ["unknown", "prohibited-effect-required"].includes(c.containment)) {
88
+ row.state = "not-observable-in-scope"; rowBlocked.add("verification-effect-or-coverage-unresolved");
89
+ }
90
+ const reviewOnly = ["documentation-review", "structure-review"].includes(c.methodId);
91
+ if (reviewOnly && c.containment !== "not-needed" || !reviewOnly && c.containment === "not-needed") rowBlocked.add("verification-containment-inconsistent");
92
+ const e = c.evidence;
93
+ if (!e) { row.missingEvidence.push("current-scoped-reference"); rowReasons.add("verification-evidence-pending"); }
94
+ else {
95
+ const age = Date.parse(d.variant.now) - Date.parse(e.observedAt);
96
+ if (revoked.has(e.referenceId)) rowBlocked.add("verification-evidence-revoked");
97
+ if (age < 0) rowBlocked.add("verification-evidence-future");
98
+ if (age > catalog.variantPolicy.maxEvidenceAgeSeconds * 1000) rowBlocked.add("verification-evidence-expired");
99
+ if (e.scopeSha256 !== r.planSha256 || e.definitionSha256 !== template.definitionSha256) rowBlocked.add("verification-binding-mismatch");
100
+ if (e.provenance === "rejected" || e.outcome === "incompatible") { row.state = "incompatible"; rowBlocked.add("verification-evidence-incompatible"); }
101
+ else if (e.basis !== provenanceBasis[e.provenance]) rowBlocked.add("verification-provenance-mismatch");
102
+ if (e.provenance === "native-claim") rowBlocked.add("verification-native-provenance-unverified");
103
+ if (e.provenance === "operator-attested") rowReasons.add("verification-attestation-not-proof");
104
+ else if (e.basis !== methodBasis[c.methodId]) rowBlocked.add("verification-method-evidence-mismatch");
105
+ if (e.outcome === "unknown") { row.missingEvidence.push("current-scoped-reference"); rowReasons.add("verification-evidence-unresolved"); }
106
+ if (!rowBlocked.size && row.state === "unresolved" && e.outcome === "supported") {
107
+ if (e.provenance === "documented") row.state = "documented-only";
108
+ if (e.provenance === "local-structure-observation") row.state = "structure-only";
109
+ if (e.provenance === "fixture-claim") row.state = "test-scoped";
110
+ }
111
+ }
112
+ }
113
+ if (rowBlocked.size && !["incompatible", "not-observable-in-scope"].includes(row.state)) row.state = "unresolved";
114
+ // Every native claim still lacks a trusted collector, regardless of apparent consistency.
115
+ rowReasons.add("verification-native-effectiveness-pending");
116
+ row.missingEvidence = [...new Set(row.missingEvidence)].sort();
117
+ row.reasons = [...new Set([...rowBlocked, ...rowReasons])].sort();
118
+ for (const reason of rowBlocked) blocked.add(reason);
119
+ for (const reason of rowReasons) reasons.add(reason);
120
+ }
121
+ r.state = blocked.size ? "blocked" : "plan-review-required";
122
+ r.reasons = [...new Set([...blocked, ...reasons])].sort();
123
+ } catch {
124
+ r.state = "invalid"; r.matrix = ISOLATED_VERIFICATION_CHECKS.map(emptyRow);
125
+ r.reasons = ["verification-invalid-input"]; r.planSha256 = null; r.variantScopeSha256 = null;
126
+ }
127
+ if (!valid.report(r)) throw Error("Isolated-verification report invariant failed");
128
+ return r;
129
+ };
130
+ }
@@ -0,0 +1,14 @@
1
+ // Platform selection is separate from authorization, ownership and process checks.
2
+ export const supportsLocalPosix = platform => platform === "darwin" || platform === "linux";
3
+
4
+ // A trusted test harness must identify its synthetic spawn explicitly. The normal
5
+ // native-client route retains its original macOS ARM64 restriction.
6
+ export const supportsDiagnosticHost = (platform, architecture, dependencies) =>
7
+ platform === "darwin" && architecture === "arm64" ||
8
+ supportsLocalPosix(platform) && dependencies.syntheticFixture === true && typeof dependencies.spawn === "function";
9
+
10
+ export const supportsPreferenceHost = (platform, source) =>
11
+ platform === "darwin" || platform === "linux" && source === "synthetic";
12
+
13
+ export const supportsAuthHost = (platform, source) =>
14
+ platform === "darwin" || platform === "linux" && source === "synthetic-fixture";