@installagent/sdk 0.9.0 → 0.9.1

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@installagent/sdk",
3
- "version": "0.9.0",
3
+ "version": "0.9.1",
4
4
  "description": "Install Agent's shared SDK for internal team operations (client repos, n8n workflows, docs search, and more).",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -34,6 +34,8 @@ installagent/
34
34
  ├── team-design/ # Install Agent design system source (tokens, components, guidelines)
35
35
  ├── team-branding/ # Logo files (static assets only)
36
36
  ├── skills/ # Cross-cutting agent skills (client deliverables pipeline, brand kit, …)
37
+ ├── team-tools/ # Internal technician tooling: the `ia` CLI, SDK, MCP server (see its AGENT.md)
38
+ ├── systems-department/ # Independent self-serve storefront repo (working name, unbranded) — own stack, no cross-imports
37
39
  ├── AGENT.md # ← you are here
38
40
  └── ONBOARDING.md # New-contractor orientation — read once, first
39
41
  ```
@@ -1,11 +1,13 @@
1
- # AGENTS.md
1
+ # AGENTS.md — installagent workspace root
2
2
 
3
- This repo's canonical agent instructions live in [`AGENT.md`](./AGENT.md).
4
- Read that file first.
3
+ Pointer file for agents that read `AGENTS.md` (Codex, Copilot, Aider,
4
+ Continue, and others). It holds no rules of its own.
5
5
 
6
- `AGENTS.md` exists so OpenAI Codex, ChatGPT desktop, and other tools that
7
- follow the [agents.md](https://agents.md) convention pick up the same rules.
8
- The contents are identical to `AGENT.md` — treat them as one document.
6
+ 1. Read [`AGENT.md`](./AGENT.md). It is the source of truth for the whole
7
+ workspace: layout, the "where to start a task" table, the golden rules,
8
+ and how the agentic files are layered.
9
+ 2. Read [`ONBOARDING.md`](./ONBOARDING.md) if you are landing here cold.
10
+ 3. Inside a repo, read that repo's `AGENT.md` (or `AGENTS.md`). It overrides
11
+ the root rules while you work there.
9
12
 
10
- If you're updating conventions, edit `AGENT.md`. Do not let these two files
11
- drift.
13
+ Do not add rule content to this file. Edit `AGENT.md` instead.
@@ -1,24 +1,12 @@
1
- # GEMINI.md
1
+ # GEMINI.md — installagent workspace root
2
2
 
3
- Instructions for the Gemini CLI agent (and other Google-powered agents)
4
- working at the root of this workspace.
3
+ Pointer file for the Gemini CLI and other Google-powered agents. It holds no
4
+ rules of its own.
5
5
 
6
- ## Read these first
6
+ 1. Read [`AGENT.md`](./AGENT.md). It is the source of truth for the whole
7
+ workspace.
8
+ 2. Read [`ONBOARDING.md`](./ONBOARDING.md) if you are landing here cold.
9
+ 3. Inside a repo, read that repo's `AGENT.md` (or `AGENTS.md`), then its
10
+ `GEMINI.md` if one exists (for example `team-web/apps/docs/GEMINI.md`).
7
11
 
8
- 1. [`AGENT.md`](./AGENT.md) — canonical conventions and rules. **This is the
9
- source of truth.**
10
- 2. [`README.md`](./README.md) — workspace overview.
11
- 3. The `AGENT.md` (or `AGENTS.md`) inside the repo you're working in:
12
- - [`clients/client-template/AGENT.md`](./clients/client-template/AGENT.md)
13
- - [`team-clients/AGENT.md`](./team-clients/AGENT.md)
14
- - [`team-infra/AGENT.md`](./team-infra/AGENT.md)
15
- - [`team-web/AGENT.md`](./team-web/AGENT.md)
16
-
17
- This root is a folder of independent git repos (`clients/client-*`,
18
- `team-*`); it is deliberately not a git repo itself. Each repo has its own
19
- conventions — always read the repo-level agentic file before editing inside it.
20
-
21
- ## Updating conventions
22
-
23
- Edit `AGENT.md` (root or repo) and any affected skills, not this file.
24
- This file is a pointer.
12
+ Do not add rule content to this file. Edit `AGENT.md` instead.
@@ -134,7 +134,9 @@ installagent/
134
134
  ├── team-web/ # installagent.com + team hub (Next.js pnpm workspace)
135
135
  ├── team-design/ # Install Agent design system source
136
136
  ├── team-branding/ # logo files
137
- └── skills/ # cross-cutting agent skills (client deliverables pipeline)
137
+ ├── skills/ # cross-cutting agent skills (client deliverables pipeline)
138
+ ├── team-tools/ # the `ia` CLI + SDK + MCP server for technicians
139
+ └── systems-department/ # independent self-serve storefront repo (unbranded working name)
138
140
  ```
139
141
 
140
142
  ## Orient yourself in this order
@@ -35,7 +35,7 @@ skills/
35
35
  ├── ia-cli/ # route internal ops through the `ia` CLI (team-tools) — decision map + guardrails
36
36
  ├── gcloud-cli-setup/ # one named gcloud configuration per account/client + check-before-you-run discipline
37
37
  ├── slack-voice/ # INTERNAL messages (Slack, email, chat): ~100 words, terse bullets, hard numbers (client → house-voice)
38
- ├── github-profile/ # force gh CLI + git commits onto the noahm-ia account before any GitHub action
38
+ ├── github-profile/ # force gh CLI + git commits onto the work account in root `.github-account` before any GitHub action
39
39
  └── init_repo/ # explicit-only /init_repo — dev branch + default branch + one milestone/root-branch per leaf issue
40
40
  ```
41
41
 
@@ -17,7 +17,7 @@ workflows, and diagrams across more than one repo. Repo-local skills live in
17
17
  ## How these get loaded
18
18
 
19
19
  Every skill is `<name>/SKILL.md` with YAML frontmatter (`name`, `description`).
20
- 23 of them are symlinked into [`../.claude/skills/`](../.claude/skills/), so Claude
20
+ 22 of them are symlinked into [`../.claude/skills/`](../.claude/skills/), so Claude
21
21
  Code and Cowork register them automatically — they appear in the skill menu and
22
22
  fire on their own without being invoked by name. The `description` is the
23
23
  trigger; the body is only read once the skill fires.
@@ -76,9 +76,17 @@ context, intake, agent bank, secrets, `wizard`/`doctor`). Check it before
76
76
  writing any custom script against GitHub, Airtable, Linear, Drive, n8n, or the
77
77
  portal.
78
78
 
79
- [`github-profile`](./github-profile/) — force gh CLI + git commits onto the
80
- `noahm-ia` account before any GitHub action on this machine (two accounts are
81
- logged in; only one is the work identity).
79
+ [`github-profile`](./github-profile/) — force gh CLI + git commits onto this
80
+ machine's work account before any GitHub action. The account comes from the
81
+ workspace-root `.github-account` file (two accounts are logged in; only one
82
+ is the work identity).
83
+
84
+ [`slack-voice`](./slack-voice/) — internal messages (Slack, email, chat):
85
+ terse, bulleted, hard numbers, about 100 words for an update. Client-facing
86
+ words stay with `house-voice`.
87
+
88
+ [`gcloud-cli-setup`](./gcloud-cli-setup/) — one named gcloud configuration
89
+ per account or client, and the check-before-you-run discipline.
82
90
 
83
91
  [`init_repo`](./init_repo/) — **explicit-invocation only**, never fires on
84
92
  its own. Run `/init_repo` against an existing `client-<slug>` repo to create
@@ -119,6 +119,9 @@ The onboarding checklist must **not feel overwhelming**. Rules:
119
119
  - **Measurable, hedged outcomes** — never guarantees.
120
120
  - **State the full commercial model** including the capped API-credit pass-through.
121
121
  - **No secrets / customer data / real VINs** in any doc.
122
+ - **No dates in the PDFs.** `brand.render_pdf` refuses them. Use "month one",
123
+ "week 4" or "at acceptance" in place of a calendar date. Pass
124
+ `allow_dates=True` only when the user explicitly asks for a date.
122
125
 
123
126
  ## Before you finish — checklist
124
127
 
@@ -80,6 +80,12 @@ numbers. Then `brand.render_pdf(body, out)` rasterizes via WeasyPrint. Content
80
80
  discipline stays with `engagement-spec` (overviews/onboarding) and
81
81
  `contract-tech-agnostic` (SOWs) — this skill only guarantees the brand.
82
82
 
83
+ **No dates in a generated PDF.** `render_pdf` raises `ValueError` if the visible
84
+ text holds a calendar date (cover date, "as of", ISO stamp). A dated PDF is
85
+ stale the day after it ships. Pass `allow_dates=True` only when the user
86
+ explicitly asks for a date (for example a dated timeline or an effective date).
87
+ Blank signature date lines are fine.
88
+
83
89
  ### Client deck (Google Slides)
84
90
 
85
91
  Two paths, one gate — full detail in
@@ -143,6 +149,8 @@ images. The logo assets here are copies of
143
149
  other hue.
144
150
  - [ ] Official logo used (PDF hero + running header); no generic glyph.
145
151
  - [ ] Generator imports `scripts/brand.py` — no hard-coded hexes.
152
+ - [ ] PDF has no dates (`render_pdf` enforces it); `allow_dates=True` only on
153
+ an explicit ask.
146
154
  - [ ] Excalidraw validates / opens; PDF previewed as PNG.
147
155
  - [ ] Deck: `deck_lint.py --render` clean **and every slide looked at** — a
148
156
  clean geometry pass is not a clean deck.
@@ -15,12 +15,17 @@ body = brand.pdf_hero(
15
15
  kicker="Statement of Work & Proposal",
16
16
  title="CarVision Pricing Agent — Phase 1",
17
17
  sub="A daily used-car repricing co-pilot.",
18
- meta_html='<div class="kicker" style="color:#8a93a0">June 16, 2026 · Confidential</div>',
18
+ meta_html='<div class="kicker" style="color:#8a93a0">Confidential</div>',
19
19
  )
20
20
  body += "<h2><span class='n'>1</span>Summary</h2><p>…</p>" # your content
21
21
  brand.render_pdf(body, "client-<slug>/.../Proposal.pdf")
22
22
  ```
23
23
 
24
+ **No dates.** `render_pdf()` scans the visible text and raises `ValueError` on
25
+ any calendar date (`June 16, 2026`, `16 June 2026`, `October 2026`,
26
+ `2026-10-20`, `10/20/26`). Do not date the cover, the footer, or an "as of"
27
+ line. Pass `allow_dates=True` only when the user explicitly asks for a date.
28
+
24
29
  - `pdf_hero()` emits the **official logo** (full lockup in the hero, icon-only in
25
30
  the running header) — no generic mark. The wordmark is set to ink on white.
26
31
  - `pdf_css()` provides page setup (Letter, margins), a running footer with
@@ -62,5 +67,7 @@ brand.render_pdf(body, "client-<slug>/.../Proposal.pdf")
62
67
  - Client-facing wording follows **contract-tech-agnostic** (SOWs) and
63
68
  **engagement-spec** (overviews/onboarding) — this skill governs *brand*, those
64
69
  govern *content*.
70
+ - **No dates in a generated PDF** unless the user explicitly asks
71
+ (`allow_dates=True`). Undated copy never goes stale.
65
72
  - Flag placeholders (`[legal entity]`, `[signatory]`) so they're filled before
66
73
  sending.
@@ -12,7 +12,7 @@ Light surfaces (client PDFs + diagrams on white) use the ink/muted neutrals
12
12
  below; the dark marketing-site neutrals in theme.css are NOT for documents.
13
13
  """
14
14
  from __future__ import annotations
15
- import json, math, random
15
+ import html, json, math, random, re
16
16
  from pathlib import Path
17
17
 
18
18
  # ─── Brand palette (mirror of theme.css — Design System v1.0 Signal Red) ─────
@@ -167,9 +167,36 @@ def pdf_hero(kicker, title, sub, meta_html="") -> str:
167
167
  {meta_html}
168
168
  </div>"""
169
169
 
170
- def render_pdf(html_body: str, out_path: str, head_extra: str = ""):
171
- """Render an HTML body (after pdf_hero + content) to a branded PDF."""
170
+ _MONTH = (r"(?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|June?|July?|"
171
+ r"Aug(?:ust)?|Sep(?:t(?:ember)?)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)")
172
+ _DATE_RES = [re.compile(p) for p in (
173
+ rf"\b{_MONTH}\.? \d{{1,2}}(?:st|nd|rd|th)?\b(?:,? \d{{4}})?", # June 16, 2026 / Oct 20
174
+ rf"\b\d{{1,2}}(?:st|nd|rd|th)? {_MONTH}\b\.?(?:,? \d{{4}})?", # 16 June 2026
175
+ rf"\b{_MONTH}\.?,? \d{{4}}\b", # October 2026
176
+ r"\b\d{4}-\d{2}-\d{2}\b", # 2026-10-20
177
+ r"\b\d{1,2}/\d{1,2}/\d{2,4}\b", # 10/20/26
178
+ )]
179
+
180
+ def find_dates(html_body: str) -> list[str]:
181
+ """Calendar dates in the VISIBLE text of an HTML body (tags, <style> and
182
+ <script> are ignored). Used by render_pdf to refuse dated PDFs."""
183
+ text = re.sub(r"(?is)<(style|script)\b.*?</\1>", " ", html_body)
184
+ text = re.sub(r"\s+", " ", html.unescape(re.sub(r"<[^>]+>", " ", text))) # \s covers &nbsp;
185
+ return [m.group(0) for rx in _DATE_RES for m in rx.finditer(text)]
186
+
187
+ def render_pdf(html_body: str, out_path: str, head_extra: str = "", allow_dates: bool = False):
188
+ """Render an HTML body (after pdf_hero + content) to a branded PDF.
189
+
190
+ House rule: a generated PDF carries NO dates (no cover date, no "as of",
191
+ no ISO stamps). A dated PDF goes stale the day after it is sent. Pass
192
+ allow_dates=True only when a date is explicitly requested (a signed
193
+ effective date, a dated timeline). Blank signature date lines are fine."""
194
+ found = find_dates(html_body)
195
+ if found and not allow_dates:
196
+ raise ValueError(
197
+ "PDF text contains date(s): " + ", ".join(sorted(set(found))[:8])
198
+ + ". Remove them, or pass allow_dates=True if the date was explicitly requested.")
172
199
  from weasyprint import HTML
173
- html = f"<!DOCTYPE html><html><head><meta charset='utf-8'><style>{pdf_css()}{head_extra}</style></head><body>{html_body}</body></html>"
174
- HTML(string=html, base_url=str(ASSET_DIR)).write_pdf(out_path)
200
+ html_doc =f"<!DOCTYPE html><html><head><meta charset='utf-8'><style>{pdf_css()}{head_extra}</style></head><body>{html_body}</body></html>"
201
+ HTML(string=html_doc, base_url=str(ASSET_DIR)).write_pdf(out_path)
175
202
  return out_path