@zalom/plastic 1.0.0-alpha.2 → 1.0.0-alpha.21

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 (76) hide show
  1. package/PLASTIC.md +128 -473
  2. package/README.md +90 -58
  3. package/agents/future-intent-researcher.md +1 -1
  4. package/agents/intent-curator.md +1 -1
  5. package/bin/plastic.js +57 -0
  6. package/bin/test +28 -0
  7. package/deprecations.yml +7 -6
  8. package/hooks/auto-arm +5 -0
  9. package/hooks/bash-gate +3 -0
  10. package/hooks/check-update +12 -8
  11. package/hooks/code-gate +10 -0
  12. package/hooks/hooks.json +25 -4
  13. package/hooks/statusline +50 -10
  14. package/package.json +2 -2
  15. package/scripts/dashboard.rb +480 -0
  16. package/scripts/doctor.rb +973 -0
  17. package/scripts/hook-auto-arm +52 -0
  18. package/scripts/hook-bash-gate +53 -0
  19. package/scripts/hook-code-gate +39 -0
  20. package/scripts/hook-continue +15 -114
  21. package/scripts/hook-gate-check +19 -4
  22. package/scripts/hook-session-start +76 -31
  23. package/scripts/install.rb +91 -480
  24. package/scripts/lib/bridge.rb +255 -0
  25. package/scripts/lib/installer_core.rb +760 -0
  26. package/scripts/migrate-to-global +1 -1
  27. package/scripts/select-update-target +93 -0
  28. package/scripts/uninstall.rb +53 -0
  29. package/scripts/update.rb +142 -0
  30. package/scripts/versions.rb +141 -0
  31. package/skills/_active-intent-gate.md +26 -0
  32. package/skills/auto/SKILL.md +62 -9
  33. package/skills/auto/evals/evals.json +92 -0
  34. package/skills/auto/references/agent-architecture.md +60 -0
  35. package/skills/brainstorming/SKILL.md +143 -0
  36. package/skills/brainstorming-grill-me/SKILL.md +5 -5
  37. package/skills/continuing/SKILL.md +102 -77
  38. package/skills/continuing/evals/evals.json +136 -0
  39. package/skills/continuing/references/context-management.md +32 -0
  40. package/skills/creating-intent/SKILL.md +16 -1
  41. package/skills/creating-intent/references/lifecycle.md +74 -0
  42. package/skills/creating-intent/references/wikilinks.md +8 -0
  43. package/skills/creating-project/SKILL.md +8 -4
  44. package/skills/creating-project/references/hubs-projects.md +55 -0
  45. package/skills/dashboard/SKILL.md +92 -0
  46. package/skills/doctor/SKILL.md +116 -0
  47. package/skills/doctor/references/gates-stuck-detection.md +38 -0
  48. package/skills/doctor/report.md +96 -0
  49. package/skills/evaluating-skills/SKILL.md +140 -0
  50. package/skills/evaluating-skills/assets/eval-template.json +12 -0
  51. package/skills/evaluating-skills/evals/evals.json +75 -0
  52. package/skills/evaluating-skills/references/convention-checks.md +76 -0
  53. package/skills/evaluating-skills/references/eval-methodology.md +154 -0
  54. package/skills/executing-plan/SKILL.md +3 -3
  55. package/skills/install/SKILL.md +56 -8
  56. package/skills/intent-curator/SKILL.md +3 -3
  57. package/skills/linking-intents/SKILL.md +5 -1
  58. package/skills/linking-intents/references/zettelkasten.md +33 -0
  59. package/skills/managing-index/SKILL.md +5 -1
  60. package/skills/releasing/SKILL.md +119 -18
  61. package/skills/releasing/references/deprecations.md +44 -0
  62. package/skills/research/SKILL.md +114 -0
  63. package/skills/savepoint/SKILL.md +46 -37
  64. package/skills/savepoint/references/context-management.md +32 -0
  65. package/skills/uninstall/SKILL.md +39 -28
  66. package/skills/update/SKILL.md +41 -36
  67. package/skills/versions/SKILL.md +65 -0
  68. package/skills/writing-instructions/SKILL.md +159 -0
  69. package/skills/writing-instructions/references/agentskills-spec.md +135 -0
  70. package/skills/writing-plans/SKILL.md +183 -0
  71. package/templates/agents.md +16 -0
  72. package/templates/outcome.md +13 -0
  73. package/templates/project.yml +5 -0
  74. package/templates/savepoint.md +14 -13
  75. package/templates/spec.md +25 -0
  76. package/bin/install.js +0 -29
@@ -0,0 +1,13 @@
1
+ # Outcome: <intent name>
2
+
3
+ ## Summary
4
+ (what was delivered)
5
+
6
+ ## Delivered
7
+ - ...
8
+
9
+ ## Verification
10
+ - <acceptance criterion> — verified by ... → result
11
+
12
+ ## Follow-ups
13
+ None
@@ -0,0 +1,5 @@
1
+ governing_docs:
2
+ - AGENTS.md
3
+
4
+ release:
5
+ on_complete: commit
@@ -1,13 +1,14 @@
1
- # Savepoint
2
-
3
- ## Last Updated
4
- {{DATE}} — Session #{{N}}
5
-
6
- ## In Progress
7
- - ...
8
-
9
- ## Blockers
10
- None
11
-
12
- ## Key Discoveries This Session
13
- - ...
1
+ # Deterministic cycle-step ledger, written automatically by the gate hook.
2
+ # One line per lifecycle milestone, append-only, newest at the bottom:
3
+ #
4
+ # {UTC-iso8601} {Stage} {milestone}
5
+ #
6
+ # Example:
7
+ # 2026-06-16T14:02:00Z What ID--slug.md
8
+ # 2026-06-16T14:20:00Z Why spec.md created
9
+ # 2026-06-16T15:10:00Z How plan.md created
10
+ # 2026-06-16T15:11:00Z How checklist.md created
11
+ # 2026-06-16T16:40:00Z Exec outcome.md created
12
+ #
13
+ # This file is sugar on top of the conventions, not a source of truth. It is
14
+ # rebuildable from files-on-disk via Bridge.rebuild_savepoint. Do not hand-edit.
@@ -0,0 +1,25 @@
1
+ # Spec: <intent name>
2
+
3
+ ## Problem
4
+ (the problem, stated as a problem, not a solution)
5
+
6
+ ## Goals
7
+ - ...
8
+
9
+ ## Non-Goals
10
+ - ...
11
+
12
+ ## Approach
13
+ (the chosen approach, in prose)
14
+
15
+ ## Alternatives Considered
16
+ - <alternative> — not chosen because ...
17
+
18
+ ## Decisions
19
+ - ...
20
+
21
+ ## Acceptance Criteria
22
+ - [ ] ...
23
+
24
+ ## Open Questions
25
+ None
package/bin/install.js DELETED
@@ -1,29 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- // Thin shim — npx entry point that delegates to the Ruby installer.
4
- // All logic lives in scripts/install.rb. JS is only the distribution mechanism.
5
-
6
- import { execFileSync } from 'node:child_process'
7
- import { resolve } from 'node:path'
8
- import { existsSync } from 'node:fs'
9
-
10
- const packageRoot = new URL('..', import.meta.url).pathname
11
- const installer = resolve(packageRoot, 'scripts', 'install.rb')
12
-
13
- if (!existsSync(installer)) {
14
- console.error('Error: scripts/install.rb not found in package.')
15
- process.exit(1)
16
- }
17
-
18
- try {
19
- execFileSync('ruby', [installer, ...process.argv.slice(2)], {
20
- stdio: 'inherit',
21
- env: { ...process.env, PLASTIC_PACKAGE_ROOT: packageRoot },
22
- })
23
- } catch (err) {
24
- if (err.status) process.exit(err.status)
25
- console.error('Error: Ruby is required to install Plastic.')
26
- console.error(' macOS: Ruby is pre-installed')
27
- console.error(' Linux: sudo apt install ruby / dnf install ruby')
28
- process.exit(1)
29
- }