@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.
Files changed (114) hide show
  1. package/dist/agent-mirror.d.ts +69 -0
  2. package/dist/agent-mirror.js +275 -0
  3. package/dist/agent-templates.d.ts +36 -2
  4. package/dist/agent-templates.js +173 -3
  5. package/dist/claude-hours.d.ts +118 -0
  6. package/dist/claude-hours.js +523 -0
  7. package/dist/client-drive.d.ts +3 -0
  8. package/dist/client-drive.js +2 -2
  9. package/dist/client-linear-create.d.ts +26 -0
  10. package/dist/client-linear-create.js +46 -0
  11. package/dist/client-linear.d.ts +28 -9
  12. package/dist/client-linear.js +36 -14
  13. package/dist/docs-search.d.ts +19 -6
  14. package/dist/docs-search.js +32 -11
  15. package/dist/doctor.d.ts +9 -0
  16. package/dist/doctor.js +126 -23
  17. package/dist/env-fill.d.ts +13 -0
  18. package/dist/env-fill.js +55 -13
  19. package/dist/env-push.d.ts +3 -0
  20. package/dist/env-push.js +11 -6
  21. package/dist/env-registry.d.ts +29 -0
  22. package/dist/env-registry.js +123 -9
  23. package/dist/exec.js +15 -2
  24. package/dist/git.d.ts +31 -0
  25. package/dist/git.js +59 -0
  26. package/dist/google-service-account.d.ts +20 -0
  27. package/dist/google-service-account.js +49 -0
  28. package/dist/hours-estimate.d.ts +43 -0
  29. package/dist/hours-estimate.js +159 -0
  30. package/dist/hours-export-schedule.d.ts +35 -0
  31. package/dist/hours-export-schedule.js +188 -0
  32. package/dist/hours-ledger.d.ts +129 -0
  33. package/dist/hours-ledger.js +882 -0
  34. package/dist/index.d.ts +25 -6
  35. package/dist/index.js +25 -6
  36. package/dist/linear-project.d.ts +2 -2
  37. package/dist/linear-project.js +2 -2
  38. package/dist/log.d.ts +28 -0
  39. package/dist/log.js +73 -0
  40. package/dist/n8n-executions.d.ts +85 -0
  41. package/dist/n8n-executions.js +259 -0
  42. package/dist/op-cli.d.ts +29 -0
  43. package/dist/op-cli.js +52 -0
  44. package/dist/platform.d.ts +35 -0
  45. package/dist/platform.js +39 -0
  46. package/dist/portal-admin.d.ts +108 -0
  47. package/dist/portal-admin.js +94 -1
  48. package/dist/standup.d.ts +88 -0
  49. package/dist/standup.js +235 -0
  50. package/dist/sync-repos.d.ts +54 -0
  51. package/dist/sync-repos.js +89 -0
  52. package/dist/template-sync.d.ts +11 -0
  53. package/dist/template-sync.js +16 -0
  54. package/dist/triage-backfill.d.ts +37 -0
  55. package/dist/triage-backfill.js +211 -0
  56. package/dist/triage-enable.d.ts +90 -0
  57. package/dist/triage-enable.js +428 -0
  58. package/dist/triage-gates.d.ts +252 -0
  59. package/dist/triage-gates.js +951 -0
  60. package/dist/wizard.d.ts +15 -0
  61. package/dist/wizard.js +35 -56
  62. package/dist/workspace-docs.d.ts +44 -0
  63. package/dist/workspace-docs.js +73 -0
  64. package/dist/workspace-push.d.ts +39 -0
  65. package/dist/workspace-push.js +78 -0
  66. package/dist/workspace-status.d.ts +37 -0
  67. package/dist/workspace-status.js +114 -0
  68. package/package.json +2 -2
  69. package/templates/env.example +37 -23
  70. package/templates/workspace-root/.claude/settings.json +12 -1
  71. package/templates/workspace-root/AGENT.md +7 -5
  72. package/templates/workspace-root/ONBOARDING.md +65 -8
  73. package/templates/workspace-root/skills/.github/workflows/pr-to-slack.yml +127 -0
  74. package/templates/workspace-root/skills/CLAUDE.md +29 -6
  75. package/templates/workspace-root/skills/README.md +171 -0
  76. package/templates/workspace-root/skills/ad-machine/SKILL.md +140 -0
  77. package/templates/workspace-root/skills/backtest-acceptance-gates/SKILL.md +293 -0
  78. package/templates/workspace-root/skills/backtest-acceptance-gates/backtest-acceptance-gates-guide.pdf +0 -0
  79. package/templates/workspace-root/skills/backtest-acceptance-gates/references/evidence-record-template.md +128 -0
  80. package/templates/workspace-root/skills/backtest-acceptance-gates/references/harness-checklist.md +90 -0
  81. package/templates/workspace-root/skills/client-deliverables/SKILL.md +1 -1
  82. package/templates/workspace-root/skills/client-deliverables/references/package-layout.md +3 -2
  83. package/templates/workspace-root/skills/client-latest/SKILL.md +343 -0
  84. package/templates/workspace-root/skills/client-latest/catchup.command.md +18 -0
  85. package/templates/workspace-root/skills/cloud-devops/SKILL.md +235 -0
  86. package/templates/workspace-root/skills/email-triage-rollout/SKILL.md +258 -0
  87. package/templates/workspace-root/skills/engagement-spec/SKILL.md +51 -18
  88. package/templates/workspace-root/skills/engagement-spec/references/spec-templates.md +10 -4
  89. package/templates/workspace-root/skills/gcloud-cli-setup/SKILL.md +100 -0
  90. package/templates/workspace-root/skills/github-profile/SKILL.md +106 -0
  91. package/templates/workspace-root/skills/google-chat-app-setup/SKILL.md +136 -0
  92. package/templates/workspace-root/skills/google-chat-app-setup/google-chat-app-setup-guide.pdf +0 -0
  93. package/templates/workspace-root/skills/house-voice/SKILL.md +80 -4
  94. package/templates/workspace-root/skills/ia-cli/SKILL.md +49 -7
  95. package/templates/workspace-root/skills/init_repo/SKILL.md +188 -0
  96. package/templates/workspace-root/skills/installagent-brand-kit/SKILL.md +59 -10
  97. package/templates/workspace-root/skills/installagent-brand-kit/assets/installagent-deck-template.pptx +0 -0
  98. package/templates/workspace-root/skills/installagent-brand-kit/references/deck-guide.md +181 -0
  99. package/templates/workspace-root/skills/installagent-brand-kit/scripts/deck.py +652 -0
  100. package/templates/workspace-root/skills/installagent-brand-kit/scripts/deck_lint.py +201 -0
  101. package/templates/workspace-root/skills/installagent-brand-kit/scripts/logo_raster.py +102 -0
  102. package/templates/workspace-root/skills/installagent-brand-kit/scripts/make_deck_template.py +290 -0
  103. package/templates/workspace-root/skills/salesforce-api-snapshot/SKILL.md +379 -0
  104. package/templates/workspace-root/skills/salesforce-api-snapshot/references/schema-discovery-soql.md +153 -0
  105. package/templates/workspace-root/skills/salesforce-api-snapshot/references/snapshot-storage.md +122 -0
  106. package/templates/workspace-root/skills/salesforce-api-snapshot/salesforce-api-snapshot-guide.pdf +0 -0
  107. package/templates/workspace-root/skills/slack-voice/SKILL.md +158 -0
  108. package/templates/workspace-root/skills/sso-gated-client-app/SKILL.md +337 -0
  109. package/templates/workspace-root/skills/sso-gated-client-app/sso-gated-client-app-guide.pdf +0 -0
  110. package/templates/workspace-root/skills/tech-call-prep/SKILL.md +146 -47
  111. package/templates/workspace-root/skills/vendor-feed-ingestion/SKILL.md +323 -0
  112. package/templates/workspace-root/skills/vendor-feed-ingestion/references/delivery-contract-template.md +110 -0
  113. package/templates/workspace-root/skills/vendor-feed-ingestion/references/feed-guards.md +134 -0
  114. 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.