joycraft 0.7.7 → 0.7.9
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.
- package/README.md +58 -319
- package/dist/{chunk-Q7TCWFTF.js → chunk-ONGWPA4M.js} +7 -2
- package/dist/chunk-ONGWPA4M.js.map +1 -0
- package/dist/{chunk-MADJOL4S.js → chunk-PBOICMDE.js} +32 -4
- package/dist/chunk-PBOICMDE.js.map +1 -0
- package/dist/{chunk-GLHRP5OB.js → chunk-RRMO5FBO.js} +2 -2
- package/dist/{chunk-VSBOHF5Z.js → chunk-VU7KVQNL.js} +63 -56
- package/dist/chunk-VU7KVQNL.js.map +1 -0
- package/dist/cli.js +6 -6
- package/dist/{init-P676ZJ4V.js → init-OJTXCK42.js} +5 -5
- package/dist/{init-autofix-V42FDZBV.js → init-autofix-LYKPMI4J.js} +3 -3
- package/dist/{upgrade-XMMV42TF.js → upgrade-ZX6ISLYO.js} +5 -5
- package/dist/{version-I5I772X6.js → version-B2CCAEMC.js} +4 -2
- package/package.json +1 -1
- package/dist/chunk-MADJOL4S.js.map +0 -1
- package/dist/chunk-Q7TCWFTF.js.map +0 -1
- package/dist/chunk-VSBOHF5Z.js.map +0 -1
- /package/dist/{chunk-GLHRP5OB.js.map → chunk-RRMO5FBO.js.map} +0 -0
- /package/dist/{init-P676ZJ4V.js.map → init-OJTXCK42.js.map} +0 -0
- /package/dist/{init-autofix-V42FDZBV.js.map → init-autofix-LYKPMI4J.js.map} +0 -0
- /package/dist/{upgrade-XMMV42TF.js.map → upgrade-ZX6ISLYO.js.map} +0 -0
- /package/dist/{version-I5I772X6.js.map → version-B2CCAEMC.js.map} +0 -0
package/README.md
CHANGED
|
@@ -8,243 +8,69 @@
|
|
|
8
8
|
|
|
9
9
|
## What is Joycraft?
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
### The core idea
|
|
14
|
-
|
|
15
|
-
- **The product:** Skills like `/joycraft-tune`, `/joycraft-new-feature`, and `/joycraft-interview` replace unstructured prompting with spec-driven development — you interview, you write specs, the agent executes — plus a harness (boundaries, context docs, skills) that gets better as you work.
|
|
16
|
-
- **The experimental frontier:** For teams with the budget and infrastructure to maintain it, the `/joycraft-implement-level5` skill sets up an autonomous loop with holdout scenario testing, and on Pi the workflow can run fully headless. Powerful, but genuinely expensive to run and maintain with current models — treat it as a north star, not the next step.
|
|
17
|
-
|
|
18
|
-
### What are the levels?
|
|
19
|
-
|
|
20
|
-
[Dan Shapiro's 5 Levels of Vibe Coding](https://www.danshapiro.com/blog/2026/01/the-five-levels-from-spicy-autocomplete-to-the-software-factory/) provides the framework:
|
|
21
|
-
|
|
22
|
-
| Level | Name | What it looks like | Joycraft's role |
|
|
23
|
-
|-------|------|--------------------|-----------------|
|
|
24
|
-
| 1 | Autocomplete | Tab-complete suggestions | - |
|
|
25
|
-
| 2 | Junior Developer | Prompt → iterate → fix → repeat | `/joycraft-tune` assesses where you are |
|
|
26
|
-
| 3 | Developer as Manager | Your life is reviewing diffs | Behavioral boundaries in CLAUDE.md |
|
|
27
|
-
| 4 | Developer as PM | You write specs, agent writes code | `/joycraft-new-feature` + `/joycraft-decompose` |
|
|
28
|
-
| 5 | Software Factory | Specs in, validated software out | `/joycraft-implement-level5` (experimental) |
|
|
29
|
-
|
|
30
|
-
Most developers plateau at Level 2. Joycraft's job is to make you excellent at
|
|
31
|
-
Levels 3-4: spec-driven development with a well-maintained harness. Level 5 is
|
|
32
|
-
real — StrongDM proved it — but with current models it takes serious budget and
|
|
33
|
-
a team to maintain, so Joycraft treats it as an experimental north star rather
|
|
34
|
-
than the destination.
|
|
35
|
-
|
|
36
|
-
### Platform support
|
|
37
|
-
|
|
38
|
-
Joycraft supports **Claude Code**, **OpenAI Codex**, **Pi**, and **GitHub Copilot** out of the box. When you run `npx joycraft init`, it opens with a quick picker — choose any combination, and only the harnesses you select get installed:
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
Which AI harnesses should Joycraft install?
|
|
42
|
-
claude — Claude Code (.claude/)
|
|
43
|
-
codex — OpenAI Codex (.agents/)
|
|
44
|
-
pi — Pi (.pi/)
|
|
45
|
-
copilot — GitHub Copilot (.github/)
|
|
46
|
-
Harnesses [comma-separated, or "all"] (none): claude,pi
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
| Harness | Skills installed to | Invocation |
|
|
50
|
-
|---------|---------------------|------------|
|
|
51
|
-
| Claude Code | `.claude/skills/` | `/joycraft-*` |
|
|
52
|
-
| Codex | `.agents/skills/` (+ `AGENTS.md`) | `$joycraft-*` |
|
|
53
|
-
| Pi | `.pi/skills/` (+ pipeline runtime, see below) | `/skill:joycraft-*` |
|
|
54
|
-
| GitHub Copilot | `.github/skills/` | — |
|
|
55
|
-
|
|
56
|
-
All four get the same structured workflows, adapted for each tool's invocation model. A single-harness install carries **no footprint from the others** — pick `copilot` only and you get `.github/skills/` with no `.claude/`, `.agents/`, or `.pi/` in sight. In a non-interactive run (CI, piped, no TTY) `init` installs all available harnesses so existing scripts keep working. The shared docs (`CLAUDE.md`, `AGENTS.md`, `docs/`) are written regardless of which harnesses you pick.
|
|
57
|
-
|
|
58
|
-
### Headless spec execution (Pi)
|
|
59
|
-
|
|
60
|
-
Pi is the one harness where the workflow can run **fully autonomously** — no human keystrokes between specs. Beyond the skills, `init` installs a pipeline runtime to `.pi/scripts/joycraft/` whose driver, `joycraft-implement-loop`, runs an entire feature's spec queue end to end:
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
next-spec → pi -p "/skill:joycraft-implement <spec>" → pi -p "/skill:joycraft-spec-done <spec>" → repeat
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
Each spec runs in **one fresh OS process** (`pi -p`), so the context isolation is the process boundary itself — verified, not in-conversation trickery. The loop is fail-fast (stops and names the failing spec) and runs `session-end` exactly once when the queue is exhausted.
|
|
67
|
-
|
|
68
|
-
This is what Claude Code and Codex can't do out of the box: an unattended `interview → PR` line where the machine does everything convergent in between. It is Pi-specific by design — the driver targets Pi with a BYO API key or open-weight model (Commercial/API terms, no automation restriction); pointing a consumer Claude/ChatGPT *subscription* at an automated loop would violate those tools' terms.
|
|
69
|
-
|
|
70
|
-
On Claude Code, `/joycraft-implement-feature` gets you the in-session equivalent: one interactive invocation runs the whole queue with a fresh-context **subagent** per spec — the subagent boundary plays the role of Pi's process boundary. You're at the keyboard and it's one command, so none of the headless ToS/cost caveats apply.
|
|
71
|
-
|
|
72
|
-
## What's new in 0.7 — the living harness
|
|
73
|
-
|
|
74
|
-
Through 0.6, Joycraft was excellent at *writing things down*: interviews became
|
|
75
|
-
briefs, briefs became specs, sessions ended with discoveries and decision-log
|
|
76
|
-
rows. What nothing enforced was whether any of it stayed **true** — specs could
|
|
77
|
-
quietly invent constraints, agents re-derived decisions the project had already
|
|
78
|
-
made, and the harness only ever grew. 0.7 closes that loop; the harness now
|
|
79
|
-
audits itself:
|
|
80
|
-
|
|
81
|
-
| | Before (≤0.6) | Now (0.7) |
|
|
82
|
-
|---|---|---|
|
|
83
|
-
| **Spec constraints** | Decompose could invent numbers/conventions that looked authoritative downstream | Every constraint carries a cite — `[src: D3]`, `[src: brief "Scope"]` — or is flagged `[src: INVENTED]` and stopped at a human gate; open decisions block decomposition entirely |
|
|
84
|
-
| **Design claims** | All claims read equally confident | Load-bearing claims are self-scored against fixed anchors (0/25/50/75/100); anything ≤50 is blocked from propagating until deepened or decided |
|
|
85
|
-
| **Prior knowledge** | Agents reasoned from scratch each phase | Research/design/decompose open with a bounded retrieval pass over `docs/context/` + `docs/discoveries/` and must cite what they reused |
|
|
86
|
-
| **Boundaries** | Prose rules an agent could drift past | `joycraft-harden` converts eligible rules into machine-checked deny patterns, stamped with provenance + a probation marker |
|
|
87
|
-
| **Harness growth** | Only ever grew | `joycraft-optimize` v2 assigns every control one of six dispositions (KEEP/ONE_HOME/LOAD_LATER/MAKE_A_CHECK/PROBATION/RETIRE); its Reaper deletes shipped feature folders only after the PR verifiably merged, and archive-moves abandoned ones |
|
|
88
|
-
| **Shipped features** | Folders sat forever; deleting lost the story | Session-end extracts a one-line ledger row to `docs/context/shipped.md` + marks the folder reap-eligible before the Reaper may touch it |
|
|
89
|
-
| **Skill surface** | All skills looked alike to discovery | Skills declare `entry: human \| agent \| situational` — human doors stay discoverable, internals get terse anti-discovery descriptions |
|
|
90
|
-
| **Trust** | The gates were assumed to work | Each gate was evaluated with N=3 fresh-context agent runs graded from tool-call timelines — one gate failed 2/3, got fixed, and re-passed 3/3 |
|
|
91
|
-
|
|
92
|
-
**Side effects to expect:** new files in your knowledge layer
|
|
93
|
-
(`docs/context/shipped.md`, `docs/context/anchors.md`,
|
|
94
|
-
`docs/reference/knowledge-lifecycle.md`), `(anchor: N)` annotations in design
|
|
95
|
-
artifacts, decompose refusing to run while a brief has an open decision, and
|
|
96
|
-
hardened rules being genuinely blocked at the hook layer — including for you.
|
|
97
|
-
|
|
98
|
-
As of **0.7.1 the full pilot ring ships in the npm package** — it piloted in
|
|
99
|
-
Joycraft's own repo first (the same discipline Joycraft asks of your projects)
|
|
100
|
-
and now needs real external projects to iterate against. The full
|
|
101
|
-
before/now/side-effects record is in [CHANGELOG.md](CHANGELOG.md).
|
|
102
|
-
|
|
103
|
-
### Upgrading to 0.7
|
|
104
|
-
|
|
105
|
-
From your project root:
|
|
11
|
+
A CLI that installs spec-driven development into [Claude Code](https://code.claude.com/docs), [OpenAI Codex](https://openai.com/codex), [Pi](https://github.com/earendil-works/pi-coding-agent), and [GitHub Copilot](https://github.com/features/copilot): skills, behavioral boundaries, templates, and a docs structure that matures with your project.
|
|
106
12
|
|
|
107
13
|
```bash
|
|
108
|
-
|
|
14
|
+
cd /path/to/your/project
|
|
15
|
+
npx joycraft@latest init
|
|
109
16
|
```
|
|
110
17
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
- **Your customizations survive.** Upgrade diffs every file it installed against
|
|
114
|
-
what's on disk: unmodified files update silently, customized files show you
|
|
115
|
-
the diff and ask. Nothing is overwritten without a yes (or `--yes` in CI).
|
|
116
|
-
- **State file moves.** `.claude/.joycraft/state.json` migrates to
|
|
117
|
-
`docs/.joycraft/state.json` (gitignored, harness-neutral) automatically.
|
|
118
|
-
- **Session-end gains the extraction step.** The next time a feature finishes,
|
|
119
|
-
it writes a `docs/context/shipped.md` ledger row and marks the brief
|
|
120
|
-
`reap: eligible` — it never deletes anything.
|
|
121
|
-
- **Every skill gains `entry:` frontmatter** (human / agent / situational).
|
|
122
|
-
Purely additive; invocation is unchanged.
|
|
123
|
-
- **Harness selection is honored.** A Codex-only project stays Codex-only.
|
|
124
|
-
- **The pilot ring arrives (0.7.1).** Two new skills (`joycraft-decide`,
|
|
125
|
-
`joycraft-harden`), the retrieval pass, the decision gate + provenance-cited
|
|
126
|
-
specs, confidence anchors, and optimize v2 with the Reaper. The gates you'll
|
|
127
|
-
feel first: decompose blocks on open decisions, and invented spec premises
|
|
128
|
-
stop at a human review before any spec file is written.
|
|
129
|
-
- **Gates get succinct (0.7.6).** Every approval bookend (brief, design,
|
|
130
|
-
decompose, research, decide, plus the tune and optimize reports) renders an
|
|
131
|
-
auto-opened HTML artifact and caps its chat message at ~10 fixed slots — the
|
|
132
|
-
markdown stays the canonical record agents read. Handoffs become fenced,
|
|
133
|
-
copy-pasteable briefing prompts. `upgrade` adds an `## Execution Profile`
|
|
134
|
-
section to AGENTS.md (swarm opt-in + per-harness model/effort) that flows
|
|
135
|
-
into those briefings. And a stale CLI now re-runs itself through
|
|
136
|
-
`npx joycraft@<latest>` instead of telling you to update separately —
|
|
137
|
-
upgrade is one command again.
|
|
138
|
-
|
|
139
|
-
**Or let your agent drive it.** Paste this prompt into Claude Code, Codex, Pi,
|
|
140
|
-
or GitHub Copilot inside your project and it will run the upgrade, show you
|
|
141
|
-
what changed, and leave a reviewable commit:
|
|
142
|
-
|
|
143
|
-
```text
|
|
144
|
-
Upgrade Joycraft in this project to 0.7. Steps: (1) Create a branch
|
|
145
|
-
chore/joycraft-0.7. (2) Run `npx joycraft@latest upgrade` interactively —
|
|
146
|
-
when it shows a diff for a file I customized, summarize the diff for me in
|
|
147
|
-
one or two sentences and ask before accepting; never blanket-accept.
|
|
148
|
-
(3) After the upgrade, list every file it changed, added, or migrated
|
|
149
|
-
(including the docs/.joycraft/state.json move), and read CHANGELOG.md's
|
|
150
|
-
0.7.0 entry from the joycraft package to explain in plain terms what
|
|
151
|
-
changed about how my harness behaves — before vs. now, plus side effects
|
|
152
|
-
I should expect. (4) Confirm my harness selection and gitignore profile
|
|
153
|
-
were preserved, and that my CLAUDE.md/AGENTS.md customizations are intact.
|
|
154
|
-
(5) Run my project's test and typecheck commands to confirm nothing broke.
|
|
155
|
-
(6) Commit the result with message "chore: upgrade joycraft to 0.7" and
|
|
156
|
-
show me the diff stat — do not push or open a PR without asking.
|
|
157
|
-
```
|
|
18
|
+
## Contents
|
|
158
19
|
|
|
159
|
-
|
|
20
|
+
- [Install](#install) · [Use](#use) · [Upgrade](#upgrade)
|
|
21
|
+
- [Setup walkthrough](docs/guides/setup-walkthrough.md) — every step from install to first feature
|
|
22
|
+
- [Which skill do I need?](#which-skill-do-i-need) — the skill table and the core loop
|
|
23
|
+
- [What init creates](#what-init-creates)
|
|
24
|
+
- [Platform support](docs/guides/platform-support.md) — Claude Code, Codex, Pi, Copilot, stacks, headless Pi
|
|
25
|
+
- [Upgrading](docs/guides/upgrading.md) — `npx joycraft@latest upgrade` and what's new in 0.7
|
|
26
|
+
- [Git tracking](docs/guides/git-tracking.md) — shared vs private profiles, reviewable PRs
|
|
27
|
+
- [Migration: flat → per-feature layout](docs/guides/migration-per-feature-layout.md) — the v0.6 docs move
|
|
28
|
+
- [The levels](docs/guides/levels.md) — Dan Shapiro's 5 Levels, where Joycraft aims, and the credits
|
|
29
|
+
- [Security](SECURITY.md) · [Guides](#guides) · [Why Joycraft?](#why-joycraft)
|
|
30
|
+
- [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) · [License](LICENSE)
|
|
160
31
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
```bash
|
|
164
|
-
npm install -g joycraft
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
Then navigate to your project's root directory and initialize:
|
|
32
|
+
## Install
|
|
168
33
|
|
|
169
34
|
```bash
|
|
170
35
|
cd /path/to/your/project
|
|
171
|
-
npx joycraft init
|
|
36
|
+
npx joycraft@latest init
|
|
172
37
|
```
|
|
173
38
|
|
|
174
|
-
|
|
39
|
+
Answer two questions — which harnesses to install, and whether to commit them — and `init` does the rest: detects your stack, writes `AGENTS.md`/`CLAUDE.md` with your real build/test commands, installs the skills. Safe to re-run: it only creates missing files, never overwrites yours.
|
|
175
40
|
|
|
176
|
-
|
|
177
|
-
- **CLAUDE.md** — on a multi-tool install this is [Anthropic's documented import pattern](https://code.claude.com/docs/en/memory): `@AGENTS.md` plus a `## Claude Code` section for Claude-specific additions, so every tool reads one source and nothing drifts. A Claude-only install gets the classic full CLAUDE.md instead
|
|
178
|
-
- **22 skills** installed to the selected harnesses — `.claude/skills/` (Claude Code), `.agents/skills/` (Codex), `.pi/skills/` (Pi), and/or `.github/skills/` (GitHub Copilot) — see [Which skill do I need?](#which-skill-do-i-need) below
|
|
179
|
-
- **Pi pipeline runtime** in `.pi/scripts/joycraft/` (when Pi is selected) — the headless spec-execution driver and its helpers
|
|
180
|
-
- **Agent teams enabled** — when Claude Code is selected, `init` sets `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in `.claude/settings.json` so subagent-driven skills like `/joycraft-research` work out of the box (idempotent — it never clobbers a value you already set)
|
|
181
|
-
- **docs/** structure: `docs/context/` is created up front; feature work lands in `docs/features/<slug>/{brief.md, research.md, design.md, specs/}` and deferred work in `docs/backlog/` — these are created lazily by the skills that write to them. Joycraft's own upgrade state lives hidden at `docs/.joycraft/state.json` (harness-neutral, gitignored — never committed)
|
|
182
|
-
- **Context documents** in `docs/context/`: production map, dangerous assumptions, decision log, institutional knowledge, and troubleshooting guide
|
|
183
|
-
- **Templates** including atomic spec, feature brief, implementation plan, boundary framework, and workflow templates for scenario generation and autofix loops
|
|
41
|
+
`npm install -g joycraft` if you'd rather have the command on your PATH; `npx` works without it. Every step from install to first shipped feature: [Setup walkthrough](docs/guides/setup-walkthrough.md).
|
|
184
42
|
|
|
185
|
-
|
|
43
|
+
## Use
|
|
186
44
|
|
|
187
|
-
|
|
45
|
+
Inside your AI tool, drive everything with slash commands:
|
|
188
46
|
|
|
189
|
-
|
|
47
|
+
```
|
|
48
|
+
/joycraft-setup # first run — onboarding, where to begin
|
|
49
|
+
/joycraft-new-feature # interview → Feature Brief → atomic specs
|
|
50
|
+
/joycraft-implement-feature docs/features/<slug>/ # run the whole spec queue, TDD per spec
|
|
51
|
+
/joycraft-session-end # wrap up: validate, graduate specs, push/PR
|
|
52
|
+
/joycraft-tune # score your harness, apply upgrades
|
|
53
|
+
```
|
|
190
54
|
|
|
191
|
-
|
|
192
|
-
gets the same skills and workflow. Some teams prefer to keep the harness local
|
|
193
|
-
and track only the docs. Choose a profile at init time:
|
|
55
|
+
Brainstorming first? `/joycraft-interview`. Fixing a bug? `/joycraft-bugfix`. The full table is at [Which skill do I need?](#which-skill-do-i-need); invocation syntax per tool is in [Platform support](docs/guides/platform-support.md).
|
|
194
56
|
|
|
195
|
-
|
|
196
|
-
npx joycraft init --gitignore=shared # default — commit .claude/, .agents/, .pi/, .github/
|
|
197
|
-
npx joycraft init --gitignore=private # gitignore them; track only CLAUDE.md, AGENTS.md, docs/
|
|
198
|
-
```
|
|
57
|
+
## Upgrade
|
|
199
58
|
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
automatically. To switch an existing project later (or decide from CI), pass the
|
|
203
|
-
same flag to upgrade: `npx joycraft upgrade --gitignore=private`. `.gitignore`
|
|
204
|
-
edits are append-only — Joycraft never rewrites or removes your existing lines.
|
|
205
|
-
|
|
206
|
-
| Profile | Tracked in git | Gitignored |
|
|
207
|
-
|---------|----------------|------------|
|
|
208
|
-
| `shared` (default) | `CLAUDE.md`, `AGENTS.md`, `docs/`, `.claude/skills/`, `.agents/`, `.pi/`, `.github/skills/` | hidden upgrade state only (`docs/.joycraft/state.json`) |
|
|
209
|
-
| `private` | `CLAUDE.md`, `AGENTS.md`, `docs/` | `.claude/`, `.agents/`, `.pi/`, `.github/skills/joycraft-*/` |
|
|
210
|
-
|
|
211
|
-
> Switching an existing project to `private` only updates `.gitignore`. If
|
|
212
|
-
> harness files were already committed, untrack them with
|
|
213
|
-
> `git rm -r --cached .claude .agents .pi .github/skills/joycraft-*` (Joycraft prints this reminder and
|
|
214
|
-
> never runs git for you).
|
|
215
|
-
>
|
|
216
|
-
> Under `private`, the harness dirs aren't committed — so a teammate who clones
|
|
217
|
-
> the repo gets `CLAUDE.md`/`AGENTS.md` but no skills until they run
|
|
218
|
-
> `npx joycraft init` to regenerate them locally. Joycraft adds a one-line
|
|
219
|
-
> reminder to your generated `CLAUDE.md` and `AGENTS.md` for exactly this reason.
|
|
220
|
-
|
|
221
|
-
### Reviewable PRs: workflow docs are collapsed
|
|
222
|
-
|
|
223
|
-
Joycraft's docs are two kinds of content. Durable knowledge — `CLAUDE.md`,
|
|
224
|
-
`AGENTS.md`, `docs/context/` — steers every future agent run and deserves review
|
|
225
|
-
eyes. Workflow exhaust — feature briefs and specs, discoveries, installed
|
|
226
|
-
templates — is historical by the time a PR is opened (the spec was reviewed in
|
|
227
|
-
conversation when it was written). To keep PRs reviewable, `init` and `upgrade`
|
|
228
|
-
write a `.gitattributes` marking the exhaust paths `linguist-generated=true`:
|
|
229
|
-
|
|
230
|
-
```gitattributes
|
|
231
|
-
docs/features/** linguist-generated=true
|
|
232
|
-
docs/bugfixes/** linguist-generated=true
|
|
233
|
-
docs/discoveries/** linguist-generated=true
|
|
234
|
-
docs/templates/** linguist-generated=true
|
|
59
|
+
```bash
|
|
60
|
+
npx joycraft@latest upgrade
|
|
235
61
|
```
|
|
236
62
|
|
|
237
|
-
|
|
238
|
-
diff stats — reviewers see your code and your durable knowledge, and any
|
|
239
|
-
collapsed doc is one click from expanding. The write is append-only and
|
|
240
|
-
idempotent (your existing `.gitattributes` lines are never touched); delete any
|
|
241
|
-
line to opt that path back into full review.
|
|
63
|
+
Refreshes skills and templates for the harnesses you selected at init. Unmodified files update automatically; files you've customized show a diff and ask first (`--yes` for CI). Details and release notes: [Upgrading](docs/guides/upgrading.md).
|
|
242
64
|
|
|
243
|
-
|
|
65
|
+
## What init creates
|
|
244
66
|
|
|
245
|
-
|
|
67
|
+
- **AGENTS.md** — behavioral boundaries (Always / Ask First / Never) plus your stack's real build/test/lint commands; the single shared instruction file when more than one tool is selected
|
|
68
|
+
- **CLAUDE.md** — on a multi-tool install, [Anthropic's documented import pattern](https://code.claude.com/docs/en/memory): `@AGENTS.md` plus a `## Claude Code` section, so every tool reads one source. A Claude-only install gets the classic full CLAUDE.md
|
|
69
|
+
- **22 skills** — installed to `.claude/skills/` (Claude Code), `.agents/skills/` (Codex), `.pi/skills/` (Pi), and/or `.github/skills/` (Copilot); Pi also gets the headless pipeline runtime in `.pi/scripts/joycraft/`
|
|
70
|
+
- **docs/** — `docs/context/` (production map, dangerous assumptions, decision log, institutional knowledge, troubleshooting) plus templates; feature folders and `docs/backlog/` are created lazily by the skills that write to them. Joycraft's own state hides at `docs/.joycraft/state.json` (gitignored)
|
|
71
|
+
- **Agent teams enabled** — with Claude Code selected, `init` sets `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in `.claude/settings.json` so subagent-driven skills work out of the box (never clobbers a value you set)
|
|
246
72
|
|
|
247
|
-
|
|
73
|
+
Re-running on an existing project is covered in [Git tracking](docs/guides/git-tracking.md#re-running-init-on-an-existing-project).
|
|
248
74
|
|
|
249
75
|
## The Workflow
|
|
250
76
|
|
|
@@ -292,117 +118,30 @@ flowchart LR
|
|
|
292
118
|
style I fill:#333,stroke:#333,color:#fff,stroke-width:2px
|
|
293
119
|
```
|
|
294
120
|
|
|
295
|
-
|
|
121
|
+
## Guides
|
|
296
122
|
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
Objective research via context isolation and 200-line design checkpoints
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
A 2-3 minute risk interview generates safety boundaries, and you choose your git autonomy level. [Read the full guide →](docs/guides/tuning.md)
|
|
310
|
-
|
|
311
|
-
### Token Discipline
|
|
312
|
-
|
|
313
|
-
Joycraft produces file artifacts at every step, so your conversation context is disposable. Clear it between phases to reduce cost and improve output quality. [Read the full guide →](docs/guides/token-discipline.md)
|
|
314
|
-
|
|
315
|
-
### Level 5: The Autonomous Loop (experimental)
|
|
316
|
-
|
|
317
|
-
Level 5 is where specs go in and validated software comes out — four GitHub Actions workflows, a separate scenarios repo, and two AI agents that can never see each other's work. It works, but budget for real token costs and ongoing scenario maintenance before committing to it. [Read the full guide →](docs/guides/level-5-autonomy.md)
|
|
318
|
-
|
|
319
|
-
### Permission Modes
|
|
320
|
-
|
|
321
|
-
You do **not** need `--dangerously-skip-permissions` for autonomous development. Claude Code offers safer alternatives. [Read the full guide →](docs/guides/permission-modes.md)
|
|
322
|
-
|
|
323
|
-
### How It Works with AI Agents
|
|
324
|
-
|
|
325
|
-
Claude Code reads CLAUDE.md, Codex and Pi read AGENTS.md — and Claude Code does **not** read AGENTS.md natively. On a multi-tool install Joycraft therefore keeps one shared AGENTS.md and writes CLAUDE.md as an `@AGENTS.md` import (Anthropic's documented pattern), so every tool reads the same instructions without duplication. [Read the full guide →](docs/guides/agent-compatibility.md)
|
|
326
|
-
|
|
327
|
-
## Upgrade
|
|
328
|
-
|
|
329
|
-
When Joycraft templates and skills evolve, update without losing your customizations:
|
|
330
|
-
|
|
331
|
-
```bash
|
|
332
|
-
npx joycraft upgrade
|
|
333
|
-
```
|
|
334
|
-
|
|
335
|
-
Joycraft tracks what it installed vs. what you've customized. Unmodified files update automatically. Customized files show a diff and ask before overwriting. Use `--yes` for CI.
|
|
336
|
-
|
|
337
|
-
`upgrade` only refreshes the harnesses you installed at init — a Codex-only project stays Codex-only and never grows a `.claude/` tree. (Projects from before harness selection existed have no recorded choice, so `upgrade` refreshes all available harnesses, preserving the old behavior.)
|
|
338
|
-
|
|
339
|
-
> **Note:** If you're upgrading from an early version, deprecated skill directories (e.g., `/joy`, `/joysmith`, `/tune`) are automatically removed during upgrade.
|
|
340
|
-
|
|
341
|
-
## Why This Exists
|
|
342
|
-
|
|
343
|
-
Most developers using AI tools are at Level 2 — and [METR's research](https://metr.org/) found they're actually slower, not faster. Joycraft packages the patterns used by teams seeing transformative results into something anyone can install. [Read the full methodology →](docs/guides/methodology.md)
|
|
344
|
-
|
|
345
|
-
## Standing on the Shoulders of Giants
|
|
346
|
-
|
|
347
|
-
Joycraft synthesizes ideas and patterns from people doing extraordinary work in AI-assisted software development:
|
|
348
|
-
|
|
349
|
-
- **[Dan Shapiro](https://x.com/danshapiro)** for the [5 Levels of Vibe Coding](https://www.danshapiro.com/blog/2026/01/the-five-levels-from-spicy-autocomplete-to-the-software-factory/) framework that Joycraft's assessment and level system is built on
|
|
350
|
-
- **[StrongDM](https://www.strongdm.com/)** / **[Justin McCarthy](https://x.com/BuiltByJustin)** for the [Software Factory](https://factory.strongdm.ai/): spec-driven autonomous development, NLSpec, external holdout scenarios, and the proof that 3 engineers can outproduce 30
|
|
351
|
-
- **[Dex Horthy](https://x.com/dexhorthy)** / **[HumanLayer](https://humanlayer.dev)** for the [RPI to CRISPY evolution](https://humanlayer.dev/blog): research isolation (hide the ticket from the researcher), the instruction budget concept (~150-200 instructions max), design discussions as high-leverage checkpoints, vertical-over-horizontal planning, and the conviction that "if your tool requires magic words, go fix the tool"
|
|
352
|
-
- **[Boris Cherny](https://x.com/bcherny)**, Head of Claude Code at Anthropic, for the interview → spec → fresh session → execute pattern and the insight that [context isolation produces better results](https://www.lennysnewsletter.com/p/head-of-claude-code-what-happens)
|
|
353
|
-
- **[Addy Osmani](https://x.com/addyosmani)** for [What makes a good spec for AI](https://addyosmani.com/blog/good-spec/): commands, testing, project structure, code style, git workflow, and boundaries
|
|
354
|
-
- **[METR](https://metr.org/)** for the [randomized control trial](https://metr.org/) that proved unstructured AI use makes experienced developers slower, validating the need for harnesses
|
|
355
|
-
- **[Nate B Jones](https://x.com/natebjones)** whose [video on the 5 Levels of Vibe Coding](https://www.youtube.com/watch?v=bDcgHzCBgmQ) made this research accessible and inspired turning Joycraft into a tool anyone can use
|
|
356
|
-
- **[Simon Willison](https://x.com/simonw)** for his [analysis of the Software Factory](https://simonwillison.net/2026/Feb/7/software-factory/) that helped contextualize StrongDM's approach for the broader community
|
|
357
|
-
- **[Anthropic](https://www.anthropic.com/)** for Claude Code's skills, hooks, and CLAUDE.md system that makes tool-native AI development possible, and the [harness patterns for long-running agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)
|
|
358
|
-
|
|
359
|
-
## Migration: Flat → Per-Feature Layout (v0.6+)
|
|
360
|
-
|
|
361
|
-
Starting in v0.6, Joycraft organizes feature artifacts into per-feature folders:
|
|
362
|
-
|
|
363
|
-
- `docs/briefs/<slug>.md` → `docs/features/<slug>/brief.md`
|
|
364
|
-
- `docs/research/<slug>.md` → `docs/features/<slug>/research.md`
|
|
365
|
-
- `docs/designs/<slug>.md` → `docs/features/<slug>/design.md`
|
|
366
|
-
- `docs/specs/<feature>/` → `docs/features/<slug>/specs/` (when `<feature>` matches a brief slug)
|
|
367
|
-
|
|
368
|
-
`npx joycraft upgrade` performs this migration automatically and forcefully on the first
|
|
369
|
-
post-upgrade run — no Y/N prompt. The CLI prints a summary of every move before applying it.
|
|
370
|
-
Spec directories under `docs/specs/` whose name doesn't match any brief slug (area-level specs
|
|
371
|
-
like bugfix folders) are left in place.
|
|
372
|
-
|
|
373
|
-
### What you'll see on the first post-upgrade run
|
|
374
|
-
|
|
375
|
-
```
|
|
376
|
-
Joycraft is migrating your docs/ to the new per-feature layout:
|
|
377
|
-
|
|
378
|
-
2026-04-01-auth-redesign/
|
|
379
|
-
docs/briefs/2026-04-01-auth-redesign.md → docs/features/2026-04-01-auth-redesign/brief.md
|
|
380
|
-
docs/research/2026-04-01-auth-redesign.md → docs/features/2026-04-01-auth-redesign/research.md
|
|
381
|
-
|
|
382
|
-
Left in place — area-level specs (e.g., bugfix areas):
|
|
383
|
-
docs/specs/login-bugfix/
|
|
384
|
-
|
|
385
|
-
Migration complete. See the README section "Migration: Flat → Per-Feature Layout"
|
|
386
|
-
for context on what changed and why. If your project is a git repo, run
|
|
387
|
-
`git status` to inspect the moves before committing.
|
|
388
|
-
```
|
|
123
|
+
| Guide | What it covers |
|
|
124
|
+
|---|---|
|
|
125
|
+
| [Setup walkthrough](docs/guides/setup-walkthrough.md) | Every step from `npm install` to your first shipped feature |
|
|
126
|
+
| [The interview](docs/guides/interview-workflow.md) | The structured interview that replaces prompt-iterate-fix — the single biggest upgrade Joycraft makes |
|
|
127
|
+
| [Research and design](docs/guides/research-and-design.md) | Objective research via context isolation, and 200-line design checkpoints before decomposition |
|
|
128
|
+
| [Test-first development](docs/guides/test-first-development.md) | Tests are the mechanism to autonomy — every spec ships a test plan, failing tests come first |
|
|
129
|
+
| [Tuning: risk interview and git autonomy](docs/guides/tuning.md) | The 2–3 minute risk interview that generates your safety boundaries |
|
|
130
|
+
| [Token discipline](docs/guides/token-discipline.md) | Why file artifacts at every step make your conversation context disposable |
|
|
131
|
+
| [Permission modes](docs/guides/permission-modes.md) | Why you do **not** need `--dangerously-skip-permissions` |
|
|
132
|
+
| [Agent compatibility](docs/guides/agent-compatibility.md) | How CLAUDE.md and AGENTS.md stay one source across four tools |
|
|
133
|
+
| [Level 5: the autonomous loop](docs/guides/level-5-autonomy.md) | Experimental — workflows, holdout scenarios, and what it really costs |
|
|
134
|
+
| [Methodology](docs/guides/methodology.md) | Why this exists: METR's slowdown finding and the teams that beat it |
|
|
389
135
|
|
|
390
|
-
|
|
136
|
+
## Why Joycraft?
|
|
391
137
|
|
|
392
|
-
|
|
393
|
-
`joycraft-decompose`, etc.) write to the new per-feature paths. Supporting both layouts
|
|
394
|
-
indefinitely would mean every skill carries dual-path branches; the forced migration keeps
|
|
395
|
-
the convention single and skills small.
|
|
138
|
+
Unstructured prompting rots: instructions pile up in one file, the agent forgets what was decided, and every session starts from zero. Joycraft replaces it with spec-driven development — you interview, you approve the brief and the specs, the agent executes with TDD — and installs a harness (boundaries, context docs, skills) that matures alongside your project instead of decaying. The gates produce shareable artifacts (markdown + HTML) your team can answer in Notion, and every brief ends with a prompt an engineer pastes straight into their coding agent.
|
|
396
139
|
|
|
397
|
-
|
|
140
|
+
The name of the game is Dan Shapiro's [5 Levels of Vibe Coding](docs/guides/levels.md): Joycraft takes a project from Level 1 to a solid Level 4, with an experimental path to 5. The reasoning and the evidence live in the [Methodology guide](docs/guides/methodology.md).
|
|
398
141
|
|
|
399
|
-
|
|
400
|
-
after the migration, you can `git mv` files anywhere — Joycraft only depends on the
|
|
401
|
-
`docs/features/<slug>/` shape for skills it ships, not on every doc living there. Git
|
|
402
|
-
history follows files via `git log --follow`.
|
|
142
|
+
## Security
|
|
403
143
|
|
|
404
|
-
|
|
405
|
-
the move is skipped and reported. The migration is idempotent.
|
|
144
|
+
Joycraft scaffolds files and never runs your code. What it reads and writes, how boundaries and deny patterns constrain your AI agent, and where to report a vulnerability: [SECURITY.md](SECURITY.md).
|
|
406
145
|
|
|
407
146
|
## Contributing
|
|
408
147
|
|
|
@@ -39,7 +39,12 @@ function ensureExecutionProfileSection(existing, profile) {
|
|
|
39
39
|
}
|
|
40
40
|
function ask(question) {
|
|
41
41
|
return new Promise((resolve) => {
|
|
42
|
-
const
|
|
42
|
+
const input = process.stdin;
|
|
43
|
+
if (input.readableEnded === true || input.destroyed === true) {
|
|
44
|
+
resolve("");
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
const rl = createInterface({ input, output: process.stdout });
|
|
43
48
|
let settled = false;
|
|
44
49
|
const done = (value) => {
|
|
45
50
|
if (settled) return;
|
|
@@ -130,4 +135,4 @@ export {
|
|
|
130
135
|
applyGitattributes,
|
|
131
136
|
getPackageVersion
|
|
132
137
|
};
|
|
133
|
-
//# sourceMappingURL=chunk-
|
|
138
|
+
//# sourceMappingURL=chunk-ONGWPA4M.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/execution-profile.ts","../src/gitattributes.ts","../src/package-version.ts"],"sourcesContent":["import { createInterface } from 'node:readline';\nimport type { Harness } from './harness.js';\n\n/**\n * The per-project **Execution Profile** (decision D6 of the succinct-gates\n * feature): which harness agents may fan out into swarms, and which model +\n * effort those agents should run at.\n *\n * It lives in exactly one home — a sentinel-delimited `## Execution Profile`\n * section in AGENTS.md. No state.json mirror: the profile is team-shared data\n * the human owns and hand-edits, and two homes for one fact violate ONE_HOME.\n *\n * It is **data only**. Nothing here recommends a model, ranks tiers, or routes\n * a stage to an agent — opinionated defaults stay in the backlogged\n * model-tiering feature (`docs/backlog/2026-07-20-model-tiering.md`, D7).\n * That is also why model and effort are free text: model names age faster than\n * Joycraft releases, so an enum here would be wrong within a minor version.\n */\n\n/** Opening sentinel — the only machine contract; everything inside is user-owned. */\nexport const EXECUTION_PROFILE_OPEN = '<!-- joycraft:execution-profile -->';\n/** Closing sentinel. */\nexport const EXECUTION_PROFILE_CLOSE = '<!-- /joycraft:execution-profile -->';\n\n/** The markdown heading the section is written under. */\nexport const EXECUTION_PROFILE_HEADING = '## Execution Profile';\n\n/**\n * The value written for model/effort when nobody was asked (non-interactive\n * init). Deliberately not a model name — it tells downstream skills \"use\n * whatever the session is already running\", which is the only answer that\n * can't go stale.\n */\nexport const SESSION_DEFAULT = 'session default';\n\nexport interface ExecutionProfileEntry {\n harness: Harness;\n /** Fan out to a swarm of subagents during `/joycraft-decompose`? */\n swarmDecompose: boolean;\n /** Fan out to a swarm of subagents during `/joycraft-implement`? */\n swarmImplement: boolean;\n /** Free-text model name, or SESSION_DEFAULT. Never validated against a list. */\n model: string;\n /** Free-text reasoning effort, or SESSION_DEFAULT. */\n effort: string;\n}\n\nexport interface ExecutionProfile {\n entries: ExecutionProfileEntry[];\n}\n\n/**\n * The profile written when nobody could be asked: skipping is first-class, so\n * the section is still written — with explicit \"no\" answers — rather than being\n * omitted. Downstream skills then read an explicit answer, never an absence.\n */\nexport function defaultExecutionProfile(harnesses: readonly Harness[]): ExecutionProfile {\n return {\n entries: harnesses.map((harness) => ({\n harness,\n swarmDecompose: false,\n swarmImplement: false,\n model: SESSION_DEFAULT,\n effort: SESSION_DEFAULT,\n })),\n };\n}\n\nfunction yn(value: boolean): string {\n return value ? 'yes' : 'no';\n}\n\n/** True when the document already carries a profile region (matched on the sentinel, not the heading). */\nexport function hasExecutionProfile(content: string): boolean {\n return content.includes(EXECUTION_PROFILE_OPEN);\n}\n\n/**\n * Render the section. One line per selected harness, so a single-harness\n * project never sees rows it didn't ask for.\n */\nexport function renderExecutionProfileSection(profile: ExecutionProfile): string {\n const lines: string[] = [EXECUTION_PROFILE_HEADING, '', EXECUTION_PROFILE_OPEN];\n for (const e of profile.entries) {\n lines.push(\n `- ${e.harness}: Swarms: decompose ${yn(e.swarmDecompose)} · implement ${yn(e.swarmImplement)} · model ${e.model} · effort ${e.effort}`\n );\n }\n lines.push(EXECUTION_PROFILE_CLOSE);\n return lines.join('\\n');\n}\n\n/**\n * Insert the section into an existing document when absent; return the document\n * untouched when a profile is already there. The sentinels make the region\n * opaque — a hand-edit inside them (even a malformed one) is preserved verbatim,\n * because the content is the user's data, not our schema (D7).\n */\nexport function ensureExecutionProfileSection(\n existing: string,\n profile: ExecutionProfile | undefined\n): string {\n if (!profile || hasExecutionProfile(existing)) return existing;\n return existing.trimEnd() + '\\n\\n' + renderExecutionProfileSection(profile) + '\\n';\n}\n\n/**\n * Ask one question, following the one-interface-per-prompt idiom the rest of\n * the CLI uses (`harness.ts`, `gitignore.ts`): open readline, ask, close.\n *\n * EOF matters more here than for those one-shot prompts, because this\n * interview asks several questions in a row: a stdin that runs out mid-way\n * (piped input, a redirect, Ctrl-D) must degrade every remaining question to\n * its stated default rather than hang or throw. Configuration questions never\n * abort an init.\n */\nfunction ask(question: string): Promise<string> {\n return new Promise((resolve) => {\n const input = process.stdin;\n // A stream that already ended emits no further 'close' on a *new* readline\n // interface, so the close-guard below never fires and the question hangs\n // forever. Detect the spent stream up front instead: this is the path a\n // short piped answer list takes once it runs out, and every remaining\n // question must degrade to its default rather than block the init.\n if (input.readableEnded === true || input.destroyed === true) {\n resolve('');\n return;\n }\n const rl = createInterface({ input, output: process.stdout });\n let settled = false;\n const done = (value: string): void => {\n if (settled) return;\n settled = true;\n rl.close();\n resolve(value);\n };\n rl.once('close', () => done(''));\n try {\n rl.question(question, (answer) => done(answer.trim()));\n } catch {\n done('');\n }\n });\n}\n\nasync function askYesNo(question: string): Promise<boolean> {\n for (let attempt = 0; attempt < 5; attempt++) {\n const answer = (await ask(`${question} [y/N]: `)).toLowerCase();\n if (answer === '' || answer === 'n' || answer === 'no') return false;\n if (answer === 'y' || answer === 'yes') return true;\n console.log(\"Please answer 'y' or 'n'.\");\n }\n // Repeated unparseable input (or a closed stream): take the default rather\n // than looping forever.\n return false;\n}\n\n/**\n * Interactive capture, one small block per selected harness. Follows the\n * harness-selection idiom in `harness.ts`: same readline interface, empty\n * answer means the stated default, unrecognized input re-asks.\n */\nasync function promptExecutionProfileInteractive(\n harnesses: readonly Harness[]\n): Promise<ExecutionProfile> {\n console.log('\\nExecution profile — how should agents run on this project?');\n console.log(' (Recorded in AGENTS.md as data. Press Enter to accept the default.)');\n const entries: ExecutionProfileEntry[] = [];\n for (const harness of harnesses) {\n console.log(`\\n ${harness}:`);\n const swarmDecompose = await askYesNo(' Use swarms for decompose?');\n const swarmImplement = await askYesNo(' Use swarms for implement?');\n const model = (await ask(` Model (${SESSION_DEFAULT}): `)) || SESSION_DEFAULT;\n const effort = (await ask(` Effort (${SESSION_DEFAULT}): `)) || SESSION_DEFAULT;\n entries.push({ harness, swarmDecompose, swarmImplement, model, effort });\n }\n return { entries };\n}\n\n/**\n * Resolve the profile for an init run:\n * - interactive (TTY): ask per selected harness\n * - non-interactive: the explicit-no default — never blocks a scripted run\n */\nexport async function resolveExecutionProfile(\n harnesses: readonly Harness[],\n interactive: boolean\n): Promise<ExecutionProfile> {\n if (harnesses.length === 0) return { entries: [] };\n if (interactive) return promptExecutionProfileInteractive(harnesses);\n return defaultExecutionProfile(harnesses);\n}\n","import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/**\n * Paths Joycraft marks `linguist-generated=true` so GitHub collapses them in\n * PR review and drops them from diff stats. These are workflow exhaust —\n * briefs, specs, discoveries, installed templates — historical artifacts by\n * the time a PR is opened (the spec was reviewed conversationally when it was\n * written). Reviewers can still expand any of them with one click.\n *\n * Deliberately NOT listed (durable knowledge that deserves review eyes):\n * CLAUDE.md, AGENTS.md, docs/context/ (steers every future agent run), and\n * docs/backlog/ (human-authored idea capture).\n */\nexport const GITATTRIBUTES_COMMENT =\n '# Joycraft: collapse generated workflow docs in PR review (expand with one click)';\n\nexport const GITATTRIBUTES_ENTRIES = [\n 'docs/features/** linguist-generated=true',\n 'docs/bugfixes/** linguist-generated=true',\n 'docs/discoveries/** linguist-generated=true',\n 'docs/templates/** linguist-generated=true',\n];\n\n/**\n * Append-only, create-if-absent, idempotent .gitattributes writer — the same\n * contract as ensureGitignoreEntries: never rewrites, reorders, or removes\n * existing lines; only appends entries not already present (matched exactly,\n * after trimming). The comment header is only added when at least one entry\n * is missing, so a fully-applied file is never touched. Returns the entries\n * actually added (empty when everything was already present).\n */\nexport function applyGitattributes(targetDir: string): string[] {\n const gitattributesPath = join(targetDir, '.gitattributes');\n const current = existsSync(gitattributesPath) ? readFileSync(gitattributesPath, 'utf-8') : '';\n const present = new Set(current.split('\\n').map((l) => l.trim()));\n const missing = GITATTRIBUTES_ENTRIES.filter((e) => !present.has(e.trim()));\n if (missing.length === 0) return [];\n\n const lines = present.has(GITATTRIBUTES_COMMENT) ? missing : [GITATTRIBUTES_COMMENT, ...missing];\n const sep = current.length > 0 && !current.endsWith('\\n') ? '\\n' : '';\n writeFileSync(gitattributesPath, current + sep + lines.join('\\n') + '\\n', 'utf-8');\n return missing;\n}\n","import { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport function getPackageVersion(): string {\n const pkgPath = join(__dirname, '..', 'package.json');\n const raw = readFileSync(pkgPath, 'utf-8');\n const pkg = JSON.parse(raw) as { version?: unknown };\n if (typeof pkg.version !== 'string' || pkg.version.length === 0) {\n throw new Error(`Joycraft package.json at ${pkgPath} is missing a version field`);\n }\n return pkg.version;\n}\n"],"mappings":";;;AAAA,SAAS,uBAAuB;AAoBzB,IAAM,yBAAyB;AAE/B,IAAM,0BAA0B;AAGhC,IAAM,4BAA4B;AAQlC,IAAM,kBAAkB;AAuBxB,SAAS,wBAAwB,WAAiD;AACvF,SAAO;AAAA,IACL,SAAS,UAAU,IAAI,CAAC,aAAa;AAAA,MACnC;AAAA,MACA,gBAAgB;AAAA,MAChB,gBAAgB;AAAA,MAChB,OAAO;AAAA,MACP,QAAQ;AAAA,IACV,EAAE;AAAA,EACJ;AACF;AAEA,SAAS,GAAG,OAAwB;AAClC,SAAO,QAAQ,QAAQ;AACzB;AAGO,SAAS,oBAAoB,SAA0B;AAC5D,SAAO,QAAQ,SAAS,sBAAsB;AAChD;AAMO,SAAS,8BAA8B,SAAmC;AAC/E,QAAM,QAAkB,CAAC,2BAA2B,IAAI,sBAAsB;AAC9E,aAAW,KAAK,QAAQ,SAAS;AAC/B,UAAM;AAAA,MACJ,KAAK,EAAE,OAAO,uBAAuB,GAAG,EAAE,cAAc,CAAC,mBAAgB,GAAG,EAAE,cAAc,CAAC,eAAY,EAAE,KAAK,gBAAa,EAAE,MAAM;AAAA,IACvI;AAAA,EACF;AACA,QAAM,KAAK,uBAAuB;AAClC,SAAO,MAAM,KAAK,IAAI;AACxB;AAQO,SAAS,8BACd,UACA,SACQ;AACR,MAAI,CAAC,WAAW,oBAAoB,QAAQ,EAAG,QAAO;AACtD,SAAO,SAAS,QAAQ,IAAI,SAAS,8BAA8B,OAAO,IAAI;AAChF;AAYA,SAAS,IAAI,UAAmC;AAC9C,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,QAAQ,QAAQ;AAMtB,QAAI,MAAM,kBAAkB,QAAQ,MAAM,cAAc,MAAM;AAC5D,cAAQ,EAAE;AACV;AAAA,IACF;AACA,UAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC5D,QAAI,UAAU;AACd,UAAM,OAAO,CAAC,UAAwB;AACpC,UAAI,QAAS;AACb,gBAAU;AACV,SAAG,MAAM;AACT,cAAQ,KAAK;AAAA,IACf;AACA,OAAG,KAAK,SAAS,MAAM,KAAK,EAAE,CAAC;AAC/B,QAAI;AACF,SAAG,SAAS,UAAU,CAAC,WAAW,KAAK,OAAO,KAAK,CAAC,CAAC;AAAA,IACvD,QAAQ;AACN,WAAK,EAAE;AAAA,IACT;AAAA,EACF,CAAC;AACH;AAEA,eAAe,SAAS,UAAoC;AAC1D,WAAS,UAAU,GAAG,UAAU,GAAG,WAAW;AAC5C,UAAM,UAAU,MAAM,IAAI,GAAG,QAAQ,UAAU,GAAG,YAAY;AAC9D,QAAI,WAAW,MAAM,WAAW,OAAO,WAAW,KAAM,QAAO;AAC/D,QAAI,WAAW,OAAO,WAAW,MAAO,QAAO;AAC/C,YAAQ,IAAI,2BAA2B;AAAA,EACzC;AAGA,SAAO;AACT;AAOA,eAAe,kCACb,WAC2B;AAC3B,UAAQ,IAAI,mEAA8D;AAC1E,UAAQ,IAAI,uEAAuE;AACnF,QAAM,UAAmC,CAAC;AAC1C,aAAW,WAAW,WAAW;AAC/B,YAAQ,IAAI;AAAA,IAAO,OAAO,GAAG;AAC7B,UAAM,iBAAiB,MAAM,SAAS,+BAA+B;AACrE,UAAM,iBAAiB,MAAM,SAAS,+BAA+B;AACrE,UAAM,QAAS,MAAM,IAAI,cAAc,eAAe,KAAK,KAAM;AACjE,UAAM,SAAU,MAAM,IAAI,eAAe,eAAe,KAAK,KAAM;AACnE,YAAQ,KAAK,EAAE,SAAS,gBAAgB,gBAAgB,OAAO,OAAO,CAAC;AAAA,EACzE;AACA,SAAO,EAAE,QAAQ;AACnB;AAOA,eAAsB,wBACpB,WACA,aAC2B;AAC3B,MAAI,UAAU,WAAW,EAAG,QAAO,EAAE,SAAS,CAAC,EAAE;AACjD,MAAI,YAAa,QAAO,kCAAkC,SAAS;AACnE,SAAO,wBAAwB,SAAS;AAC1C;;;AC/LA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AAad,IAAM,wBACX;AAEK,IAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,SAAS,mBAAmB,WAA6B;AAC9D,QAAM,oBAAoB,KAAK,WAAW,gBAAgB;AAC1D,QAAM,UAAU,WAAW,iBAAiB,IAAI,aAAa,mBAAmB,OAAO,IAAI;AAC3F,QAAM,UAAU,IAAI,IAAI,QAAQ,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAChE,QAAM,UAAU,sBAAsB,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1E,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAElC,QAAM,QAAQ,QAAQ,IAAI,qBAAqB,IAAI,UAAU,CAAC,uBAAuB,GAAG,OAAO;AAC/F,QAAM,MAAM,QAAQ,SAAS,KAAK,CAAC,QAAQ,SAAS,IAAI,IAAI,OAAO;AACnE,gBAAc,mBAAmB,UAAU,MAAM,MAAM,KAAK,IAAI,IAAI,MAAM,OAAO;AACjF,SAAO;AACT;;;AC3CA,SAAS,gBAAAA,qBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,SAAS,QAAAC,aAAY;AAE9B,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAEjD,SAAS,oBAA4B;AAC1C,QAAM,UAAUA,MAAK,WAAW,MAAM,cAAc;AACpD,QAAM,MAAMD,cAAa,SAAS,OAAO;AACzC,QAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,MAAI,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,WAAW,GAAG;AAC/D,UAAM,IAAI,MAAM,4BAA4B,OAAO,6BAA6B;AAAA,EAClF;AACA,SAAO,IAAI;AACb;","names":["readFileSync","join"]}
|
|
@@ -96,7 +96,10 @@ function readVersion(dir) {
|
|
|
96
96
|
version: parsed.version,
|
|
97
97
|
files: parsed.files,
|
|
98
98
|
...profile ? { gitignoreProfile: profile } : {},
|
|
99
|
-
...harnesses ? { harnesses } : {}
|
|
99
|
+
...harnesses ? { harnesses } : {},
|
|
100
|
+
// Only a real boolean counts; anything else is treated as absent
|
|
101
|
+
// (and absent means true at every call site).
|
|
102
|
+
...typeof parsed.autoOpen === "boolean" ? { autoOpen: parsed.autoOpen } : {}
|
|
100
103
|
};
|
|
101
104
|
}
|
|
102
105
|
return null;
|
|
@@ -104,11 +107,30 @@ function readVersion(dir) {
|
|
|
104
107
|
return null;
|
|
105
108
|
}
|
|
106
109
|
}
|
|
107
|
-
function writeVersion(dir, version, files, gitignoreProfile, harnesses) {
|
|
110
|
+
function writeVersion(dir, version, files, gitignoreProfile, harnesses, autoOpen) {
|
|
108
111
|
const filePath = join(dir, STATE_PATH);
|
|
109
112
|
const existing = readVersion(dir);
|
|
110
113
|
const profile = gitignoreProfile ?? existing?.gitignoreProfile;
|
|
111
114
|
const selectedHarnesses = harnesses ?? existing?.harnesses;
|
|
115
|
+
const openSetting = autoOpen ?? existing?.autoOpen;
|
|
116
|
+
let unknownKeys = {};
|
|
117
|
+
if (existsSync(filePath)) {
|
|
118
|
+
try {
|
|
119
|
+
const raw = JSON.parse(readFileSync(filePath, "utf-8"));
|
|
120
|
+
if (raw && typeof raw === "object" && !Array.isArray(raw)) {
|
|
121
|
+
const {
|
|
122
|
+
version: _v,
|
|
123
|
+
files: _f,
|
|
124
|
+
gitignoreProfile: _g,
|
|
125
|
+
harnesses: _h,
|
|
126
|
+
autoOpen: _a,
|
|
127
|
+
...rest
|
|
128
|
+
} = raw;
|
|
129
|
+
unknownKeys = rest;
|
|
130
|
+
}
|
|
131
|
+
} catch {
|
|
132
|
+
}
|
|
133
|
+
}
|
|
112
134
|
const truncated = {};
|
|
113
135
|
for (const [path, hash] of Object.entries(files)) {
|
|
114
136
|
truncated[path] = truncateHash(hash);
|
|
@@ -117,11 +139,16 @@ function writeVersion(dir, version, files, gitignoreProfile, harnesses) {
|
|
|
117
139
|
version,
|
|
118
140
|
files: truncated,
|
|
119
141
|
...profile ? { gitignoreProfile: profile } : {},
|
|
120
|
-
...selectedHarnesses ? { harnesses: selectedHarnesses } : {}
|
|
142
|
+
...selectedHarnesses ? { harnesses: selectedHarnesses } : {},
|
|
143
|
+
...openSetting !== void 0 ? { autoOpen: openSetting } : {},
|
|
144
|
+
...unknownKeys
|
|
121
145
|
};
|
|
122
146
|
mkdirSync(dirname(filePath), { recursive: true });
|
|
123
147
|
writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
|
|
124
148
|
}
|
|
149
|
+
function getAutoOpen(dir) {
|
|
150
|
+
return readVersion(dir)?.autoOpen ?? true;
|
|
151
|
+
}
|
|
125
152
|
function getLevel(dir) {
|
|
126
153
|
const hasAutofix = existsSync(join(dir, ".github", "workflows", "autofix.yml"));
|
|
127
154
|
if (!hasAutofix) return 4;
|
|
@@ -144,6 +171,7 @@ export {
|
|
|
144
171
|
truncateHash,
|
|
145
172
|
readVersion,
|
|
146
173
|
writeVersion,
|
|
174
|
+
getAutoOpen,
|
|
147
175
|
getLevel
|
|
148
176
|
};
|
|
149
|
-
//# sourceMappingURL=chunk-
|
|
177
|
+
//# sourceMappingURL=chunk-PBOICMDE.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/version.ts","../src/harness.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { sanitizeHarnesses, type Harness } from './harness.js';\n\n/**\n * Project-relative path to Joycraft's upgrade-state file.\n *\n * Hidden inside `docs/` — the one directory `init` always creates regardless of\n * which harnesses are selected — so a single-harness install carries no\n * foreign-harness footprint (a Codex-only project has no `.claude/`, etc.). The\n * state is Joycraft's own bookkeeping (version, file hashes, gitignore profile),\n * not a harness artifact, so it lives in a harness-neutral home. Never at the\n * repo root, never committed (init/upgrade gitignore it).\n *\n * Two legacy locations are migrated on upgrade: the original repo-root\n * `.joycraft-version` (see LEGACY_VERSION_FILE) and the later\n * `.claude/.joycraft/state.json` (see LEGACY_CLAUDE_STATE_PATH).\n */\nexport const STATE_PATH = join('docs', '.joycraft', 'state.json');\n\n/** The original repo-root state path. Kept only so `upgrade` can migrate it. */\nexport const LEGACY_VERSION_FILE = '.joycraft-version';\n\n/**\n * The interim `.claude/`-nested state path, used before state moved to a\n * harness-neutral `docs/` home. Kept only so `upgrade` can migrate it (and so a\n * Codex/Pi-only re-init stops leaving a stray `.claude/` behind).\n */\nexport const LEGACY_CLAUDE_STATE_PATH = join('.claude', '.joycraft', 'state.json');\n\n/**\n * Length we truncate stored hashes to. Full SHA-256 is 64 hex chars; 16 hex\n * (64 bits) is ample to detect customization across ~100 managed files and\n * shrinks the state ~4×. Compare truncated-on-both-sides (see upgrade.ts).\n */\nconst HASH_LENGTH = 16;\n\n/**\n * How much of the Joycraft harness is tracked in git.\n * - `shared` — commit skills/agents/pi so teammates get the workflow (default).\n * - `private` — gitignore .claude/, .agents/, .pi/; track only CLAUDE.md,\n * AGENTS.md, and docs/.\n */\nexport type GitignoreProfile = 'shared' | 'private';\n\nexport const DEFAULT_GITIGNORE_PROFILE: GitignoreProfile = 'shared';\n\n/**\n * Narrow an arbitrary value to a GitignoreProfile, or null if unrecognized.\n * Strings are normalized (trim + lowercase) here so every call site — flag,\n * prompt, persisted state — gets the same case-insensitivity for free.\n */\nexport function parseGitignoreProfile(value: unknown): GitignoreProfile | null {\n const v = typeof value === 'string' ? value.trim().toLowerCase() : value;\n return v === 'shared' || v === 'private' ? v : null;\n}\n\nexport interface VersionInfo {\n version: string;\n files: Record<string, string>;\n /**\n * The gitignore profile chosen at init/upgrade. Absent on state written by\n * Joycraft versions before this field existed — treat absent as `shared`.\n */\n gitignoreProfile?: GitignoreProfile;\n /**\n * The harnesses installed at init (claude/codex/pi). `upgrade` reads this so\n * it only refreshes the harnesses the project actually uses. Absent on state\n * written before harness selection existed — callers treat absent as \"all\n * three\" for backward compatibility.\n */\n harnesses?: Harness[];\n /**\n * Whether gate skills auto-open rendered HTML artifacts (`open`/`xdg-open`).\n * Absent means true — auto-open was unconditional before this field existed.\n * Persisted here (not a new file) per D12; tune offers the toggle.\n */\n autoOpen?: boolean;\n}\n\nexport function hashContent(content: string): string {\n return createHash('sha256').update(content).digest('hex');\n}\n\n/** Truncate a (full) content hash to the stored length. Idempotent for already-short input. */\nexport function truncateHash(hash: string): string {\n return hash.slice(0, HASH_LENGTH);\n}\n\nexport function readVersion(dir: string): VersionInfo | null {\n const filePath = join(dir, STATE_PATH);\n if (!existsSync(filePath)) return null;\n try {\n const raw = readFileSync(filePath, 'utf-8');\n const parsed = JSON.parse(raw);\n if (typeof parsed.version === 'string' && typeof parsed.files === 'object') {\n // Sanitize the profile: ignore unknown/legacy values rather than\n // returning them (absent or bogus → undefined, callers default to shared).\n const profile = parseGitignoreProfile(parsed.gitignoreProfile);\n // Sanitize harnesses similarly: drop unknown tokens; null (not an array)\n // means \"no recorded selection\" → callers default to all available.\n const harnesses = sanitizeHarnesses(parsed.harnesses);\n return {\n version: parsed.version,\n files: parsed.files,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(harnesses ? { harnesses } : {}),\n // Only a real boolean counts; anything else is treated as absent\n // (and absent means true at every call site).\n ...(typeof parsed.autoOpen === 'boolean' ? { autoOpen: parsed.autoOpen } : {}),\n };\n }\n return null;\n } catch {\n return null;\n }\n}\n\nexport function writeVersion(\n dir: string,\n version: string,\n files: Record<string, string>,\n gitignoreProfile?: GitignoreProfile,\n harnesses?: Harness[],\n autoOpen?: boolean\n): void {\n const filePath = join(dir, STATE_PATH);\n // An omitted profile/harness-list/autoOpen means \"no new decision\", not\n // \"clear it\": preserve whatever is already persisted so call sites that only\n // refresh version/hashes can never silently strip a saved choice.\n const existing = readVersion(dir);\n const profile = gitignoreProfile ?? existing?.gitignoreProfile;\n const selectedHarnesses = harnesses ?? existing?.harnesses;\n const openSetting = autoOpen ?? existing?.autoOpen;\n // Unknown keys survive rewrites (D12): a newer Joycraft may have stamped\n // fields this version doesn't know about. Known keys are stripped from the\n // raw pass-through so the sanitized values above stay authoritative.\n let unknownKeys: Record<string, unknown> = {};\n if (existsSync(filePath)) {\n try {\n const raw = JSON.parse(readFileSync(filePath, 'utf-8'));\n if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n const {\n version: _v,\n files: _f,\n gitignoreProfile: _g,\n harnesses: _h,\n autoOpen: _a,\n ...rest\n } = raw as Record<string, unknown>;\n unknownKeys = rest;\n }\n } catch {\n // Unreadable state is rewritten from scratch — same as readVersion's null.\n }\n }\n // Store truncated hashes — single source of truth for the on-disk shape.\n const truncated: Record<string, string> = {};\n for (const [path, hash] of Object.entries(files)) {\n truncated[path] = truncateHash(hash);\n }\n const data: VersionInfo = {\n version,\n files: truncated,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(selectedHarnesses ? { harnesses: selectedHarnesses } : {}),\n ...(openSetting !== undefined ? { autoOpen: openSetting } : {}),\n ...unknownKeys,\n };\n mkdirSync(dirname(filePath), { recursive: true });\n writeFileSync(filePath, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n}\n\n/**\n * The persisted auto-open setting for gate HTML renders. Missing state file or\n * missing/invalid key both mean true — auto-open was unconditional before the\n * setting existed, and that stays the default.\n */\nexport function getAutoOpen(dir: string): boolean {\n return readVersion(dir)?.autoOpen ?? true;\n}\n\n/**\n * Detect the current Joycraft harness level for a project directory.\n * Returns 5 if Level 5 artifacts (autofix workflow + External Validation) are present, 4 otherwise.\n */\nexport function getLevel(dir: string): number {\n const hasAutofix = existsSync(join(dir, '.github', 'workflows', 'autofix.yml'));\n if (!hasAutofix) return 4;\n const claudeMdPath = join(dir, 'CLAUDE.md');\n if (!existsSync(claudeMdPath)) return 4;\n const content = readFileSync(claudeMdPath, 'utf-8');\n return content.includes('## External Validation') ? 5 : 4;\n}\n","import { createInterface } from 'node:readline';\n\n/**\n * The AI coding harnesses Joycraft can install into a project. Each maps to a\n * config dir:\n * - claude → .claude/ (Claude Code)\n * - codex → .agents/ (OpenAI Codex)\n * - pi → .pi/ (Pi)\n * - copilot → .github/ (GitHub Copilot)\n *\n * Single source of truth: the menu, the parser, and the install gates in\n * init.ts all derive from this list so a new harness can't leave a path stale.\n */\nexport const HARNESSES = ['claude', 'codex', 'pi', 'copilot'] as const;\nexport type Harness = (typeof HARNESSES)[number];\n\n/** Human-readable one-liner per harness, shown in the interactive menu. */\nconst HARNESS_LABELS: Record<Harness, string> = {\n claude: 'Claude Code (.claude/)',\n codex: 'OpenAI Codex (.agents/)',\n pi: 'Pi (.pi/)',\n copilot: 'GitHub Copilot (.github/)',\n};\n\nfunction isHarness(value: string): value is Harness {\n return (HARNESSES as readonly string[]).includes(value);\n}\n\n/**\n * Sanitize an arbitrary value (e.g. parsed from state.json) into a harness list,\n * dropping anything unrecognized rather than rejecting the whole list — old or\n * hand-edited state must degrade gracefully. Returns null when the input isn't\n * an array at all (caller treats null as \"no recorded selection\"). Order follows\n * the canonical HARNESSES order and is deduped.\n */\nexport function sanitizeHarnesses(value: unknown): Harness[] | null {\n if (!Array.isArray(value)) return null;\n const present = new Set(\n value.filter((v): v is string => typeof v === 'string').map((v) => v.trim().toLowerCase())\n );\n return HARNESSES.filter((h) => present.has(h));\n}\n\n/**\n * Parse a comma/space-separated answer into a deduped, validated harness list.\n * Returns null when any token is unrecognized so the caller can re-ask rather\n * than silently dropping a typo. An empty answer yields an empty array (the\n * \"install nothing\" case the caller handles explicitly).\n */\nexport function parseHarnessSelection(answer: string): Harness[] | null {\n const tokens = answer\n .split(/[,\\s]+/)\n .map((t) => t.trim().toLowerCase())\n .filter((t) => t.length > 0);\n\n // \"all\" is a convenience alias for every harness.\n if (tokens.length === 1 && tokens[0] === 'all') {\n return [...HARNESSES];\n }\n\n const selected: Harness[] = [];\n for (const token of tokens) {\n if (!isHarness(token)) return null;\n if (!selected.includes(token)) selected.push(token);\n }\n return selected;\n}\n\n/**\n * Interactive multi-select for which harnesses to install. An empty answer is a\n * deliberate \"none\" — the caller prints the run-again message and bails. An\n * unrecognized token re-asks instead of being coerced.\n */\nasync function promptHarnesses(): Promise<Harness[]> {\n const rl = createInterface({ input: process.stdin, output: process.stdout });\n console.log('\\nWhich AI harnesses should Joycraft install?');\n for (const h of HARNESSES) {\n console.log(` ${h.padEnd(7)} — ${HARNESS_LABELS[h]}`);\n }\n return new Promise((resolve) => {\n const ask = (): void => {\n rl.question('Harnesses [comma-separated, or \"all\"] (none): ', (answer) => {\n const parsed = parseHarnessSelection(answer);\n if (parsed !== null) {\n rl.close();\n resolve(parsed);\n return;\n }\n console.log(\n `Unrecognized harness in '${answer.trim()}' — choose from ${HARNESSES.join(', ')} (comma-separated), or leave empty for none.`\n );\n ask();\n });\n };\n ask();\n });\n}\n\n/**\n * Resolve which harnesses to install:\n * - interactive (TTY): show the multi-select menu; honor an empty \"none\"\n * - non-interactive: install all available harnesses, preserving long-standing init behavior\n * for scripted/CI runs that can't answer a prompt.\n */\nexport async function resolveHarnesses(interactive: boolean): Promise<Harness[]> {\n if (interactive) {\n return promptHarnesses();\n }\n return [...HARNESSES];\n}\n"],"mappings":"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","names":[]}
|
|
@@ -3,7 +3,7 @@ import {
|
|
|
3
3
|
DEFAULT_GITIGNORE_PROFILE,
|
|
4
4
|
STATE_PATH,
|
|
5
5
|
parseGitignoreProfile
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-PBOICMDE.js";
|
|
7
7
|
|
|
8
8
|
// src/gitignore.ts
|
|
9
9
|
import { existsSync, readFileSync, writeFileSync } from "fs";
|
|
@@ -84,4 +84,4 @@ export {
|
|
|
84
84
|
validateGitignoreFlag,
|
|
85
85
|
resolveGitignoreProfile
|
|
86
86
|
};
|
|
87
|
-
//# sourceMappingURL=chunk-
|
|
87
|
+
//# sourceMappingURL=chunk-RRMO5FBO.js.map
|