@installagent/sdk 0.1.0 → 0.3.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.
- package/dist/agent-mirror.d.ts +69 -0
- package/dist/agent-mirror.js +275 -0
- package/dist/agent-templates.d.ts +36 -2
- package/dist/agent-templates.js +173 -3
- package/dist/claude-hours.d.ts +118 -0
- package/dist/claude-hours.js +523 -0
- package/dist/client-drive.d.ts +3 -0
- package/dist/client-drive.js +2 -2
- package/dist/client-linear-create.d.ts +26 -0
- package/dist/client-linear-create.js +46 -0
- package/dist/client-linear.d.ts +28 -9
- package/dist/client-linear.js +36 -14
- package/dist/docs-search.d.ts +19 -6
- package/dist/docs-search.js +32 -11
- package/dist/doctor.d.ts +9 -0
- package/dist/doctor.js +126 -23
- package/dist/env-fill.d.ts +13 -0
- package/dist/env-fill.js +55 -13
- package/dist/env-push.d.ts +3 -0
- package/dist/env-push.js +11 -6
- package/dist/env-registry.d.ts +29 -0
- package/dist/env-registry.js +123 -9
- package/dist/exec.js +15 -2
- package/dist/git.d.ts +31 -0
- package/dist/git.js +59 -0
- package/dist/google-service-account.d.ts +20 -0
- package/dist/google-service-account.js +49 -0
- package/dist/hours-estimate.d.ts +43 -0
- package/dist/hours-estimate.js +159 -0
- package/dist/hours-export-schedule.d.ts +35 -0
- package/dist/hours-export-schedule.js +188 -0
- package/dist/hours-ledger.d.ts +129 -0
- package/dist/hours-ledger.js +882 -0
- package/dist/index.d.ts +25 -6
- package/dist/index.js +25 -6
- package/dist/linear-project.d.ts +2 -2
- package/dist/linear-project.js +2 -2
- package/dist/log.d.ts +28 -0
- package/dist/log.js +73 -0
- package/dist/n8n-executions.d.ts +85 -0
- package/dist/n8n-executions.js +259 -0
- package/dist/op-cli.d.ts +29 -0
- package/dist/op-cli.js +52 -0
- package/dist/platform.d.ts +35 -0
- package/dist/platform.js +39 -0
- package/dist/portal-admin.d.ts +108 -0
- package/dist/portal-admin.js +94 -1
- package/dist/standup.d.ts +88 -0
- package/dist/standup.js +235 -0
- package/dist/sync-repos.d.ts +54 -0
- package/dist/sync-repos.js +89 -0
- package/dist/template-sync.d.ts +11 -0
- package/dist/template-sync.js +16 -0
- package/dist/triage-backfill.d.ts +37 -0
- package/dist/triage-backfill.js +211 -0
- package/dist/triage-enable.d.ts +90 -0
- package/dist/triage-enable.js +428 -0
- package/dist/triage-gates.d.ts +252 -0
- package/dist/triage-gates.js +951 -0
- package/dist/wizard.d.ts +15 -0
- package/dist/wizard.js +35 -56
- package/dist/workspace-docs.d.ts +44 -0
- package/dist/workspace-docs.js +73 -0
- package/dist/workspace-push.d.ts +39 -0
- package/dist/workspace-push.js +78 -0
- package/dist/workspace-status.d.ts +37 -0
- package/dist/workspace-status.js +114 -0
- package/package.json +2 -2
- package/templates/env.example +37 -23
- package/templates/workspace-root/.claude/settings.json +12 -1
- package/templates/workspace-root/AGENT.md +7 -5
- package/templates/workspace-root/ONBOARDING.md +65 -8
- package/templates/workspace-root/skills/.github/workflows/pr-to-slack.yml +127 -0
- package/templates/workspace-root/skills/CLAUDE.md +29 -6
- package/templates/workspace-root/skills/README.md +171 -0
- package/templates/workspace-root/skills/ad-machine/SKILL.md +140 -0
- package/templates/workspace-root/skills/backtest-acceptance-gates/SKILL.md +293 -0
- package/templates/workspace-root/skills/backtest-acceptance-gates/backtest-acceptance-gates-guide.pdf +0 -0
- package/templates/workspace-root/skills/backtest-acceptance-gates/references/evidence-record-template.md +128 -0
- package/templates/workspace-root/skills/backtest-acceptance-gates/references/harness-checklist.md +90 -0
- package/templates/workspace-root/skills/client-deliverables/SKILL.md +1 -1
- package/templates/workspace-root/skills/client-deliverables/references/package-layout.md +3 -2
- package/templates/workspace-root/skills/client-latest/SKILL.md +343 -0
- package/templates/workspace-root/skills/client-latest/catchup.command.md +18 -0
- package/templates/workspace-root/skills/cloud-devops/SKILL.md +235 -0
- package/templates/workspace-root/skills/email-triage-rollout/SKILL.md +258 -0
- package/templates/workspace-root/skills/engagement-spec/SKILL.md +51 -18
- package/templates/workspace-root/skills/engagement-spec/references/spec-templates.md +10 -4
- package/templates/workspace-root/skills/gcloud-cli-setup/SKILL.md +100 -0
- package/templates/workspace-root/skills/github-profile/SKILL.md +106 -0
- package/templates/workspace-root/skills/google-chat-app-setup/SKILL.md +136 -0
- package/templates/workspace-root/skills/google-chat-app-setup/google-chat-app-setup-guide.pdf +0 -0
- package/templates/workspace-root/skills/house-voice/SKILL.md +80 -4
- package/templates/workspace-root/skills/ia-cli/SKILL.md +49 -7
- package/templates/workspace-root/skills/init_repo/SKILL.md +188 -0
- package/templates/workspace-root/skills/installagent-brand-kit/SKILL.md +59 -10
- package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-deck-template.pptx +0 -0
- package/templates/workspace-root/skills/installagent-brand-kit/references/deck-guide.md +181 -0
- package/templates/workspace-root/skills/installagent-brand-kit/scripts/deck.py +652 -0
- package/templates/workspace-root/skills/installagent-brand-kit/scripts/deck_lint.py +201 -0
- package/templates/workspace-root/skills/installagent-brand-kit/scripts/logo_raster.py +102 -0
- package/templates/workspace-root/skills/installagent-brand-kit/scripts/make_deck_template.py +290 -0
- package/templates/workspace-root/skills/salesforce-api-snapshot/SKILL.md +379 -0
- package/templates/workspace-root/skills/salesforce-api-snapshot/references/schema-discovery-soql.md +153 -0
- package/templates/workspace-root/skills/salesforce-api-snapshot/references/snapshot-storage.md +122 -0
- package/templates/workspace-root/skills/salesforce-api-snapshot/salesforce-api-snapshot-guide.pdf +0 -0
- package/templates/workspace-root/skills/slack-voice/SKILL.md +158 -0
- package/templates/workspace-root/skills/sso-gated-client-app/SKILL.md +337 -0
- package/templates/workspace-root/skills/sso-gated-client-app/sso-gated-client-app-guide.pdf +0 -0
- package/templates/workspace-root/skills/tech-call-prep/SKILL.md +146 -47
- package/templates/workspace-root/skills/vendor-feed-ingestion/SKILL.md +323 -0
- package/templates/workspace-root/skills/vendor-feed-ingestion/references/delivery-contract-template.md +110 -0
- package/templates/workspace-root/skills/vendor-feed-ingestion/references/feed-guards.md +134 -0
- package/templates/workspace-root/skills/vendor-feed-ingestion/vendor-feed-ingestion-guide.pdf +0 -0
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
# Client decks — the template, the builder, and the mistakes not to repeat
|
|
2
|
+
|
|
3
|
+
Two paths to an on-brand deck. Both end in the same linter.
|
|
4
|
+
|
|
5
|
+
| You are… | Use | Then |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Writing a deck by hand | `assets/installagent-deck-template.pptx` | Upload to Drive → it converts to native Google Slides → duplicate the slide whose *shape* fits your point |
|
|
8
|
+
| Generating a deck in code | `scripts/deck.py` | `python scripts/deck_lint.py yourdeck.pptx --render` before you hand it over |
|
|
9
|
+
|
|
10
|
+
Both are generated from `scripts/brand.py`, which mirrors the single brand
|
|
11
|
+
source (`team-web/packages/ui/theme.css`). **Nothing here contains a hex
|
|
12
|
+
literal, and neither should your deck script.**
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## The hand-built path
|
|
17
|
+
|
|
18
|
+
1. Upload `assets/installagent-deck-template.pptx` to the client's Drive
|
|
19
|
+
folder — or to your own and copy it. Drive converts `.pptx` to native
|
|
20
|
+
Slides on upload, keeping the layout.
|
|
21
|
+
2. Slide 2 is the read-me. Read it, then delete it before sharing.
|
|
22
|
+
3. **Duplicate, don't create.** Right-click a slide → Duplicate, then type over
|
|
23
|
+
it. A slide you add from scratch loses the type stack and the spacing.
|
|
24
|
+
4. Delete every archetype you didn't use. A ten-slide template is not a
|
|
25
|
+
ten-slide deck.
|
|
26
|
+
5. Fix the footer date and the `n/N` page numbers — they are text, not fields.
|
|
27
|
+
|
|
28
|
+
The file's **OOXML theme** is patched too, so Slides reports the theme as
|
|
29
|
+
"Install Agent" and a text box you add by hand inherits Hanken Grotesk and
|
|
30
|
+
deep red instead of Calibri and Office blue.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## The generated path
|
|
35
|
+
|
|
36
|
+
```python
|
|
37
|
+
import sys
|
|
38
|
+
sys.path.append("/Users/…/skills/installagent-brand-kit/scripts")
|
|
39
|
+
from deck import Deck, RED, RED_SIG, MUTED
|
|
40
|
+
|
|
41
|
+
d = Deck(client="Acme Co", date="14 Sep 2026", total=4)
|
|
42
|
+
|
|
43
|
+
d.cover("ACME CO", "Where we are, and what we need to decide today",
|
|
44
|
+
"Attendees 14 September 2026 · 60 minutes",
|
|
45
|
+
outcomes=[("A priority order", "we all agree on"),
|
|
46
|
+
("A timeline", "you can plan against"),
|
|
47
|
+
("A short list", "of what we need from you")])
|
|
48
|
+
|
|
49
|
+
s = d.slide("01 · already working", "One thing is live",
|
|
50
|
+
"And it has been for two weeks.")
|
|
51
|
+
d.pipeline(s, [("inbox", "Mail arrives", "Any hour"),
|
|
52
|
+
("read", "Classified", "Understood, not matched"),
|
|
53
|
+
("file", "Filed", "Your own labels"),
|
|
54
|
+
("act", "Archived", "By itself")], accent=3)
|
|
55
|
+
d.callout(s, "The sentence you want repeated back to you.", "One clause more.")
|
|
56
|
+
|
|
57
|
+
s = d.slide("02 · what we need", "From your side",
|
|
58
|
+
"None of this is engineering time.")
|
|
59
|
+
d.tiles(s, [("⚠", "The blocker", "What it unlocks.", "OWNER — VERB", True),
|
|
60
|
+
("→", "A question", "Asked, not answered.", "OWNER", False)], cols=4)
|
|
61
|
+
|
|
62
|
+
s = d.slide("03 · next steps", "The next seven days")
|
|
63
|
+
d.kanban(s, [("TODAY", RED, [(1, "Thing", "US", False)]),
|
|
64
|
+
("THIS WEEK", RED_SIG, [(2, "Their thing", "THEM", True)]),
|
|
65
|
+
("LATER", MUTED, [(3, "Dated thing", "US", False)])])
|
|
66
|
+
|
|
67
|
+
d.save("acme-deck.pptx")
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
**Archetypes** (all take the `Slide` returned by `d.slide()` and advance its
|
|
71
|
+
cursor, so you can stack two on one page):
|
|
72
|
+
|
|
73
|
+
`cover` · `pipeline` · `ladder` · `cards` · `flow` (with a struck-out cut step)
|
|
74
|
+
· `gantt` · `tiles` · `decisions` · `chat` · `kanban` · plus `table`,
|
|
75
|
+
`callout`, `question_band`, `panel`, `stat`.
|
|
76
|
+
|
|
77
|
+
For a bespoke diagram — a map, a topology — use `panel()` for the left-hand
|
|
78
|
+
narrative card; it returns the x where the free area starts. Draw into that
|
|
79
|
+
area with the primitives (`card`, `bar`, `badge`, `pill`, `arrow`, `rule`) so
|
|
80
|
+
the diagram stays on-palette.
|
|
81
|
+
|
|
82
|
+
`d.save()` refuses to write if the slide count doesn't match `total=` — the
|
|
83
|
+
footer page numbers would otherwise lie.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## The mistakes this exists to prevent
|
|
88
|
+
|
|
89
|
+
Every one of these reached a draft. Ordered by how badly it would have landed.
|
|
90
|
+
|
|
91
|
+
### Brand
|
|
92
|
+
|
|
93
|
+
1. **Building a client deck on the marketing site's dark palette.** The site is
|
|
94
|
+
always-dark; **documents live on white with `#d11a1a`**. `brand-tokens.md`
|
|
95
|
+
is explicit: the dark `theme.css` neutrals are *"for the always-dark
|
|
96
|
+
marketing site — do not use them for client PDFs or diagrams."*
|
|
97
|
+
2. **Introducing a second hue for semantics** — blue "client" pins, amber
|
|
98
|
+
"stale" markers. **Red is the only hue.** Meaning rides on glyphs
|
|
99
|
+
(`✓ → ⚠ ✕`), fill weight, and dashed-vs-solid outlines. `deck_lint.py`
|
|
100
|
+
fails the build on any hex not in `brand.py`.
|
|
101
|
+
3. **Using signal red `#ff2d2d` as decoration.** It means attention. Deep red
|
|
102
|
+
`#d11a1a` is the primary; if everything is bright red, nothing is urgent.
|
|
103
|
+
4. **Re-creating the logo**, or screenshotting it. `logo_raster.py` rasterises
|
|
104
|
+
the official SVGs — full lockup on the cover, icon mark in every running
|
|
105
|
+
header. `deck_lint.py` fails a slide with no logo at all.
|
|
106
|
+
|
|
107
|
+
### Rendering — things that look fine locally and break on the projector
|
|
108
|
+
|
|
109
|
+
5. **1px rules.** A `GRID`-coloured shape 9525 EMU thick is invisible
|
|
110
|
+
projected. The gantt gridlines shipped this way. Floor is **12700 EMU**;
|
|
111
|
+
`deck.HAIRLINE` is that value.
|
|
112
|
+
6. **Glyphs that don't resolve.** `▮`/`▯` rendered as tiny boxes and a missing
|
|
113
|
+
glyph. Draw swatch shapes instead. The linter has a denylist; `✓ → ⚠ ✕ ● ★
|
|
114
|
+
◌` are safe.
|
|
115
|
+
7. **`\n` inside a run.** Renderers disagree on whether it breaks. `deck.py`
|
|
116
|
+
strips it; add a second paragraph, or let `word_wrap` do the work.
|
|
117
|
+
8. **`Inches(13.333)` for a 16:9 width.** That is 12191695 EMU — 305 short of
|
|
118
|
+
true 16:9 against 7.5in, so Slides rescales on import. Use
|
|
119
|
+
`Emu(12192000)`, which `deck.py` does.
|
|
120
|
+
9. **Text frames overhanging the footer.** `deck.tb()` clamps every frame to
|
|
121
|
+
`BOTTOM_SAFE`; the linter fails on any shape past the slide edge.
|
|
122
|
+
10. **A "radius" stretched into an ellipse.** If your diagram's coordinate
|
|
123
|
+
space isn't square, a circle sized in *units* comes out oval. Size radial
|
|
124
|
+
things in **inches**, not canvas units.
|
|
125
|
+
11. **Labels colliding with the thing they label.** Only visible by looking.
|
|
126
|
+
|
|
127
|
+
### Content — not enforceable, but the expensive kind
|
|
128
|
+
|
|
129
|
+
12. **An unrun test quoted as a passing score.** A `25/25` reached a
|
|
130
|
+
client-facing slide while the workplan said the set had *"not yet [been]
|
|
131
|
+
run."* Every number on a slide needs a source file; if there is no
|
|
132
|
+
evidence file, say what you actually have.
|
|
133
|
+
13. **A status word doing more work than the repo supports.** "Finished",
|
|
134
|
+
"the only thing left", "it tracks his edits" — each was one phase ahead of
|
|
135
|
+
reality. Grep the workplan before you write a status word.
|
|
136
|
+
14. **A claim that undercuts your own ask.** "Carries no patient data" two
|
|
137
|
+
slides before asking them to sign a data-handling agreement.
|
|
138
|
+
15. **Contradicting a stakeholder who will be in the room.** A slide said
|
|
139
|
+
"read-only" about a tool whose owner had explicitly required it be
|
|
140
|
+
editable. Read the last call's notes before you write the roadmap slide.
|
|
141
|
+
|
|
142
|
+
The linter cannot catch 12–15. The client repo's `CADENCE.md` § surface matrix
|
|
143
|
+
is the process that does: every claim traces to `docs/`, and `docs/` traces to
|
|
144
|
+
a call note.
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
148
|
+
## Verifying a deck before you send it
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
python scripts/deck_lint.py mydeck.pptx --render
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Errors block; warnings are advisory (word count over 180, hairlines).
|
|
155
|
+
|
|
156
|
+
**`--render` is the step people skip and shouldn't.** There is no LibreOffice
|
|
157
|
+
on most of our machines, so the only local way to *see* a `.pptx` is macOS
|
|
158
|
+
Quick Look — and `qlmanage` previews only slide 1. The linter works around that
|
|
159
|
+
by splitting the deck into one file per slide and rendering each. It is the
|
|
160
|
+
only check that catches composition: collisions, dead whitespace, a shape
|
|
161
|
+
covering half the page. On the deck this guide came from, geometry was clean
|
|
162
|
+
and **eight defects were still visible**.
|
|
163
|
+
|
|
164
|
+
Then: upload to Drive, and confirm after conversion that Hanken Grotesk and
|
|
165
|
+
JetBrains Mono resolved (both are Google Fonts and normally do) and that any
|
|
166
|
+
hand-drawn diagram survived.
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## Regenerating the template
|
|
171
|
+
|
|
172
|
+
After any change to `theme.css`, `brand.py`, or `deck.py`:
|
|
173
|
+
|
|
174
|
+
```bash
|
|
175
|
+
cd scripts
|
|
176
|
+
python make_deck_template.py
|
|
177
|
+
python deck_lint.py ../assets/installagent-deck-template.pptx --render
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
Never hand-edit the `.pptx` in `assets/` — it is a build artifact, and a manual
|
|
181
|
+
edit is how it drifts from the brand source.
|