@njeybe/nativ 2.3.0 → 2.4.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 (57) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/README.md +676 -190
  3. package/dist/commands/db.js +3 -0
  4. package/dist/commands/doctor.d.ts +2 -1
  5. package/dist/commands/doctor.js +4 -0
  6. package/dist/commands/init.js +1 -0
  7. package/dist/commands/learn.d.ts +19 -0
  8. package/dist/commands/learn.js +121 -0
  9. package/dist/commands/session.d.ts +22 -0
  10. package/dist/commands/session.js +106 -0
  11. package/dist/commands/task.js +34 -7
  12. package/dist/commands/verify.js +6 -0
  13. package/dist/core/code-shape.js +4 -2
  14. package/dist/core/enforcement.d.ts +1 -0
  15. package/dist/core/enforcement.js +22 -4
  16. package/dist/core/harness-integrity.d.ts +15 -0
  17. package/dist/core/harness-integrity.js +198 -0
  18. package/dist/core/human-gate.d.ts +7 -0
  19. package/dist/core/human-gate.js +16 -0
  20. package/dist/core/learnings.d.ts +63 -0
  21. package/dist/core/learnings.js +227 -0
  22. package/dist/core/root-resolver.d.ts +5 -0
  23. package/dist/core/root-resolver.js +46 -0
  24. package/dist/core/session-memory.d.ts +42 -0
  25. package/dist/core/session-memory.js +121 -0
  26. package/dist/core/setup-assets.d.ts +1 -1
  27. package/dist/core/setup-assets.js +5 -2
  28. package/dist/core/verifier.d.ts +36 -0
  29. package/dist/core/verifier.js +92 -4
  30. package/dist/db/introspector.js +59 -59
  31. package/dist/governor/store.d.ts +18 -0
  32. package/dist/governor/store.js +53 -0
  33. package/dist/index.js +41 -0
  34. package/dist/mcp/server.js +12 -0
  35. package/dist/runner/agent-supervisor.d.ts +21 -3
  36. package/dist/runner/agent-supervisor.js +80 -20
  37. package/dist/scanner/types.d.ts +1 -0
  38. package/dist/server/studio-server.js +1 -130
  39. package/dist/server/studio-ui/shell/dispatch.js +3 -9
  40. package/dist/server/studio-ui/shell/model.js +3 -1
  41. package/package.json +2 -2
  42. package/plugin/.claude-plugin/plugin.json +2 -2
  43. package/plugin/agents/architect.md +3 -3
  44. package/plugin/agents/explorer.md +49 -0
  45. package/plugin/agents/worker.md +2 -1
  46. package/plugin/skills/nativ/SKILL.md +15 -0
  47. package/templates/AGENTS.md +15 -0
  48. package/templates/CLAUDE.md +32 -32
  49. package/templates/GEMINI.md +2 -2
  50. package/templates/claude-agents/architect.md +3 -3
  51. package/templates/claude-agents/explorer.md +49 -0
  52. package/templates/claude-agents/worker.md +2 -1
  53. package/templates/dot-ai/api_contracts.json +66 -66
  54. package/templates/dot-ai/context.md +38 -38
  55. package/templates/dot-ai/db_schema.json +39 -39
  56. package/templates/dot-ai/subagents/frontend.md +33 -0
  57. package/templates/dot-ai/ui_specs.md +17 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,58 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.4.0
4
+
5
+ ### Added
6
+
7
+ - **Learnings.** `nativ learn propose` (and the `nativ_learn_propose` MCP tool) records a project
8
+ lesson the contracts do not capture. A human approves it with `nativ learn approve` in an
9
+ interactive terminal, after seeing the full lesson; a lesson that changed during review is not
10
+ decided. Approved lessons reach `nativ task next --json` as `learnings`, scoped to the task's
11
+ role and target files, at most five.
12
+ - **Verify phases.** `verifyPhases` in `.nativ/config.json` lists checks (type check, lint) that
13
+ run before every task's own command in `nativ verify` (once per batch), the `task complete`
14
+ gatekeeper and Studio dispatch. They are always read from the main checkout, and an unreadable
15
+ config fails verification instead of skipping it. A failure names the phase, in Studio too.
16
+ - **Escalation history.** `nativ task next --json` adds `priorEscalations`: the task's settled
17
+ escalations with how each was settled, so a worker does not raise a settled gap again.
18
+ - **Explorer agent.** An `explorer` subagent with only Read, Grep and Glob (Sonnet; the project
19
+ manager passes Haiku for a quick lookup) maps existing code: layout, components, routes, data
20
+ models, conventions, drift against the contracts, and suggested target files for a feature. The
21
+ architect saves its report as `.ai/codebase_map.md` after the human approves, stamped with the
22
+ commit it describes.
23
+ - **Harness checks in `nativ doctor`.** Flags `disableAllHooks` (fail) and `bypassPermissions`
24
+ (warning) in project or local Claude settings, settings files it cannot read, well-known
25
+ credential formats in files agents read (file and line only, never the value), roles with no
26
+ guide, hand-edited role guides, lessons waiting for approval, an unreadable lessons file,
27
+ and a `ui_specs.md` that predates the Marketing pages checks.
28
+
29
+ ### Changed
30
+
31
+ - `nativ task unlock`, `nativ task complete --no-verify` and `nativ db sync --yes` now refuse to run
32
+ without an interactive terminal, like `nativ learn approve`. Agents run headless, so this holds
33
+ even where no permission rule is installed. `task unlock --revoke` still works anywhere.
34
+ - Completing a task closes its pending escalations, and Studio's Needs you no longer lists
35
+ completed tasks.
36
+ - The enforcement hook reads the enforcement mode and unlocks from the main checkout, also inside a
37
+ task worktree, and guards `../..` paths from a worktree into the main checkout's `.ai/`, `.nativ/`
38
+ and secrets.
39
+ - `.nativ/` is protected like `.ai/`: the enforcement hook flags agent edits there, setup adds ask
40
+ rules for it, and Studio's native runner refuses it. Agents are also denied reading
41
+ `.nativ/*.local.json`.
42
+ - Design-time rules (fonts, color, marketing page layout) moved into the Anti-Generic Checklist of
43
+ the `ui_specs.md` template, checked by the architect. The frontend guide keeps build-time rules,
44
+ and its design read applies only to Standard or Full work that renders a screen.
45
+
46
+ ## 2.3.1
47
+
48
+ ### Fixed
49
+
50
+ - Studio Dispatch on Windows: task text with quotes or symbols like > could cut off the agent's instructions and send its output to a stray file.
51
+
52
+ ### Removed
53
+
54
+ - The simulation endpoints (`/api/pipeline/simulation/start` and `/stop`) that fed the old Workflow Canvas.
55
+
3
56
  ## 2.3.0
4
57
 
5
58
  ### Changed