npm - @agentproto/agencies - Versions diffs - 0.1.0-alpha.0 - Mend

@agentproto/agencies 0.1.0-alpha.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 (35) hide show

package/AGENTAGENCIES.md +39 -0
package/LICENSE +21 -0
package/README.md +90 -0
package/dist/capacity-98VwY285.d.ts +862 -0
package/dist/chunk-DYQ4A5HV.mjs +649 -0
package/dist/chunk-DYQ4A5HV.mjs.map +1 -0
package/dist/chunk-GAJQ5ZC2.mjs +149 -0
package/dist/chunk-GAJQ5ZC2.mjs.map +1 -0
package/dist/chunk-SOJ4GQR7.mjs +3 -0
package/dist/chunk-SOJ4GQR7.mjs.map +1 -0
package/dist/composition/index.d.ts +61 -0
package/dist/composition/index.mjs +75 -0
package/dist/composition/index.mjs.map +1 -0
package/dist/doctypes/index.d.ts +61 -0
package/dist/doctypes/index.mjs +4 -0
package/dist/doctypes/index.mjs.map +1 -0
package/dist/index.d.ts +32 -0
package/dist/index.mjs +17 -0
package/dist/index.mjs.map +1 -0
package/dist/renderers/index.d.ts +288 -0
package/dist/renderers/index.mjs +321 -0
package/dist/renderers/index.mjs.map +1 -0
package/dist/validators/index.d.ts +70 -0
package/dist/validators/index.mjs +4 -0
package/dist/validators/index.mjs.map +1 -0
package/package.json +94 -0
package/src/spec/canvakit-templates/agency.agency-overview/template.canvakit.html +173 -0
package/src/spec/canvakit-templates/agency.agency-profile/template.canvakit.html +121 -0
package/src/spec/canvakit-templates/agency.agreement-signing/template.canvakit.html +164 -0
package/src/spec/canvakit-templates/agency.deliverable-review/template.canvakit.html +148 -0
package/src/spec/canvakit-templates/agency.engagement-dashboard/template.canvakit.html +191 -0
package/src/spec/canvakit-templates/agency.invoice-pdf/template.canvakit.html +142 -0
package/src/spec/canvakit-templates/agency.procedure-card/template.canvakit.html +93 -0
package/src/spec/snippets/agency-overview-rollup/procedures/compute-agency-overview/PROCEDURE.md +88 -0
package/src/spec/snippets/agency-overview-rollup/routines/agency-overview-rollup/ROUTINE.md +58 -0

package/src/spec/canvakit-templates/agency.agreement-signing/template.canvakit.html ADDED Viewed

@@ -0,0 +1,164 @@
+---
+template: true
+name: agency.agreement-signing
+version: 1.0.0-alpha
+description: |
+  Multi-party signing portal for AGREEMENT.md. Differs from
+  governance.signing-portal in three ways:
+    1. Renders the agreement body (line items, payment terms, scope) above the form.
+    2. Shows the multi-party signature status — already-signed parties are listed.
+    3. Knows about the agencies/v1 vocabulary (counterparty / operator / agent).
+  The host application:
+    - Reads AGREEMENT.md, computes documentHash, builds the signer list.
+    - Generates a single-use nonce + signing URL per pending signer.
+    - Receives the form POST and writes signature.json via signArtifactTool.
+author: agencies.sh
+variables:
+  agencyName: "Agency"
+  agreementTitle: "Agreement"
+  agreementPath: "engagements/example/AGREEMENT.md"
+  agreementBodyHtml: ""
+  documentHash: "0000000000000000000000000000000000000000000000000000000000000000"
+  signerKind: "counterparty"
+  signerSlug: "example-corp"
+  signerName: ""
+  signerEmail: ""
+  nonce: ""
+  signUrl: "/api/agency/sign-agreement"
+  alreadySignedParties: []
+  pendingParties: []
+  lineItems: []
+  totalFormatted: "0.00"
+  currency: "EUR"
+  paymentTermsHtml: ""
+sources: {}
+---
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Sign: {{agreementTitle}} · {{agencyName}}</title>
+    <style>
+      :root { --fg: #1a1a1a; --muted: #666; --bg: #faf9f7; --panel: #fff; --border: #e5e5e5; --accent: #1a1a1a; --ok: #0a7d30; --warn: #b45309; }
+      body { font: 15px/1.55 ui-sans-serif, system-ui, sans-serif; max-width: 44rem; margin: 0 auto; padding: 2.5rem 1.5rem; color: var(--fg); background: var(--bg); }
+      h1 { font-size: 1.5rem; letter-spacing: -0.01em; margin: 0 0 0.25rem; }
+      .lead { color: var(--muted); margin: 0 0 2rem; font-size: 0.9375rem; }
+      .panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 1.5rem; margin-bottom: 1.25rem; }
+      .panel h2 { font-size: 0.8125rem; text-transform: uppercase; letter-spacing: 0.08em; color: #666; margin: 0 0 0.875rem; }
+      .body { font-size: 0.9375rem; line-height: 1.6; color: #222; }
+      .body :is(p, ul, ol, blockquote) { margin: 0 0 0.75rem; }
+      table.lines { width: 100%; border-collapse: collapse; margin: 0; }
+      table.lines th { text-align: left; font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--muted); padding: 0.5rem 0.75rem; border-bottom: 1.5px solid var(--accent); font-weight: 600; }
+      table.lines td { padding: 0.5rem 0.75rem; border-bottom: 1px solid #efece5; }
+      table.lines td.num { text-align: right; font-variant-numeric: tabular-nums; }
+      .total { display: flex; justify-content: space-between; margin-top: 0.75rem; padding-top: 0.75rem; border-top: 2px solid var(--accent); font-weight: 600; font-size: 1.0625rem; }
+      .signers { display: grid; gap: 0.5rem; }
+      .signer { display: flex; justify-content: space-between; align-items: center; padding: 0.625rem 0.875rem; background: #f7f5ee; border-radius: 6px; font-size: 0.875rem; }
+      .signer .who { font-weight: 500; }
+      .signer .when { font-family: ui-monospace, SF Mono, monospace; font-size: 0.8125rem; color: var(--muted); }
+      .pill { display: inline-block; padding: 0.125rem 0.5rem; border-radius: 999px; font-size: 0.6875rem; font-weight: 500; vertical-align: middle; }
+      .pill.ok { background: #e7f5eb; color: var(--ok); }
+      .pill.warn { background: #fef3c7; color: var(--warn); }
+      .field { margin-bottom: 1rem; }
+      label { display: block; font-size: 0.875rem; font-weight: 500; margin-bottom: 0.375rem; }
+      input { width: 100%; padding: 0.625rem 0.75rem; border: 1px solid #d4d4d4; border-radius: 6px; font: inherit; box-sizing: border-box; background: #fff; }
+      input:focus { outline: 2px solid #2563eb; outline-offset: -2px; }
+      button { width: 100%; padding: 0.75rem 1rem; background: var(--accent); color: #fff; border: 0; border-radius: 6px; font: inherit; font-weight: 500; cursor: pointer; }
+      button:hover { background: #000; }
+      .meta { font-size: 0.8125rem; color: var(--muted); padding: 0.75rem 0.875rem; background: #f5f4f0; border: 1px solid var(--border); border-radius: 6px; margin-bottom: 1rem; }
+      .meta dl { margin: 0; display: grid; grid-template-columns: max-content 1fr; gap: 0.25rem 0.75rem; }
+      .meta dt { font-weight: 500; color: #444; }
+      .meta dd { margin: 0; font-family: ui-monospace, SF Mono, monospace; font-size: 0.75rem; word-break: break-all; }
+      .legal { font-size: 0.8125rem; color: #777; line-height: 1.6; margin-top: 1rem; }
+      .legal em { font-style: normal; font-weight: 500; color: var(--fg); }
+    </style>
+  </head>
+  <body>
+    <p class="lead">{{agencyName}} · agreement signing</p>
+    <h1>{{agreementTitle}}</h1>
+    {{#agreementBodyHtml}}
+    <section class="panel body">
+      {{{agreementBodyHtml}}}
+    </section>
+    {{/agreementBodyHtml}}
+    {{#lineItems.length}}
+    <section class="panel">
+      <h2>Line items</h2>
+      <table class="lines">
+        <thead><tr><th>Description</th><th class="num">Qty</th><th class="num">Total</th></tr></thead>
+        <tbody>
+          {{#lineItems}}
+          <tr><td>{{description}}</td><td class="num">{{quantity}}</td><td class="num">{{totalFormatted}}</td></tr>
+          {{/lineItems}}
+        </tbody>
+      </table>
+      <div class="total"><span>Total</span><span>{{totalFormatted}} {{currency}}</span></div>
+      {{#paymentTermsHtml}}<div style="margin-top:0.875rem;color:var(--muted);font-size:0.875rem;">{{{paymentTermsHtml}}}</div>{{/paymentTermsHtml}}
+    </section>
+    {{/lineItems.length}}
+    {{#alreadySignedParties.length}}
+    <section class="panel">
+      <h2>Already signed</h2>
+      <div class="signers">
+        {{#alreadySignedParties}}
+        <div class="signer">
+          <span class="who">{{label}} <span class="pill ok">signed</span></span>
+          <span class="when">{{signedAt}}</span>
+        </div>
+        {{/alreadySignedParties}}
+      </div>
+    </section>
+    {{/alreadySignedParties.length}}
+    {{#pendingParties.length}}
+    <section class="panel">
+      <h2>Pending signatures</h2>
+      <div class="signers">
+        {{#pendingParties}}
+        <div class="signer">
+          <span class="who">{{label}} <span class="pill warn">pending</span></span>
+          <span class="when">{{deadline}}</span>
+        </div>
+        {{/pendingParties}}
+      </div>
+    </section>
+    {{/pendingParties.length}}
+    <section class="panel">
+      <h2>Your signature</h2>
+      <p style="margin:0 0 1rem;color:var(--muted);font-size:0.875rem;">
+        You are signing on behalf of <strong>{{signerKind}}:{{signerSlug}}</strong>.
+      </p>
+      <form action="{{signUrl}}" method="POST">
+        <input type="hidden" name="nonce" value="{{nonce}}" />
+        <input type="hidden" name="artifactPath" value="{{agreementPath}}" />
+        <input type="hidden" name="documentHash" value="{{documentHash}}" />
+        <input type="hidden" name="signer" value="{{signerKind}}:{{signerSlug}}" />
+        <input type="hidden" name="signerKind" value="{{signerKind}}" />
+        {{#signerEmail}}<input type="hidden" name="signerEmail" value="{{signerEmail}}" />{{/signerEmail}}
+        <div class="field">
+          <label for="signerName">Type your full legal name to sign</label>
+          <input id="signerName" name="signerName" type="text" required value="{{signerName}}" autocomplete="name" />
+        </div>
+        <button type="submit">Sign agreement</button>
+      </form>
+    </section>
+    <div class="meta">
+      <dl>
+        <dt>Document</dt><dd>{{agreementPath}}</dd>
+        <dt>SHA-256</dt><dd>{{documentHash}}</dd>
+      </dl>
+    </div>
+    <p class="legal">
+      Typing your name and clicking <em>Sign agreement</em> creates a binding electronic signature on this version of the document. Your typed name, IP, browser user agent, and the document SHA-256 hash above are recorded as evidence. If the document changes, this signature does not apply to the new version.
+    </p>
+  </body>
+</html>

package/src/spec/canvakit-templates/agency.deliverable-review/template.canvakit.html ADDED Viewed

@@ -0,0 +1,148 @@
+---
+template: true
+name: agency.deliverable-review
+version: 1.0.0-alpha
+description: |
+  Counterparty validation page for a DELIVERABLE.md. Shows the work product
+  (description + attachments + screenshot previews), then offers two paths:
+  approve (typed-name signature → workflow advances) or request revisions
+  (writes a feedback comment + advances workflow back to `revise`).
+  Connection to data:
+    - Reads DELIVERABLE.md frontmatter for status, requiredSignatures, attachments[].
+    - The host computes documentHash over deliverable bytes + attachment refs.
+    - Approval POSTs to /sign — same endpoint as agreement / invoice signing.
+    - Revision request POSTs to /revise — host appends a comment + flips status.
+author: agencies.sh
+variables:
+  agencyName: "Agency"
+  deliverableTitle: "Deliverable"
+  deliverablePath: "engagements/example/deliverables/v1/DELIVERABLE.md"
+  deliverableBodyHtml: ""
+  documentHash: "0000000000000000000000000000000000000000000000000000000000000000"
+  signerKind: "counterparty"
+  signerSlug: "example-corp"
+  signerName: ""
+  signerEmail: ""
+  nonce: ""
+  signUrl: "/api/agency/sign-deliverable"
+  reviseUrl: "/api/agency/revise-deliverable"
+  attachments: []
+  context: ""
+  engagementName: ""
+sources: {}
+---
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Review: {{deliverableTitle}}</title>
+    <style>
+      :root { --fg: #1a1a1a; --muted: #666; --bg: #faf9f7; --panel: #fff; --border: #e5e5e5; --accent: #1a1a1a; --ok: #0a7d30; --danger: #b91c1c; }
+      body { font: 15px/1.55 ui-sans-serif, system-ui, sans-serif; max-width: 44rem; margin: 0 auto; padding: 2.5rem 1.5rem; color: var(--fg); background: var(--bg); }
+      h1 { font-size: 1.5rem; letter-spacing: -0.01em; margin: 0 0 0.25rem; }
+      .lead { color: var(--muted); margin: 0 0 2rem; font-size: 0.9375rem; }
+      .panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 1.5rem; margin-bottom: 1.25rem; }
+      .panel h2 { font-size: 0.8125rem; text-transform: uppercase; letter-spacing: 0.08em; color: #666; margin: 0 0 0.875rem; }
+      .body { font-size: 0.9375rem; line-height: 1.6; color: #222; }
+      .body :is(p, ul, ol, blockquote) { margin: 0 0 0.75rem; }
+      .attachments { display: grid; gap: 0.625rem; }
+      .attachment { display: flex; gap: 0.875rem; align-items: center; padding: 0.75rem 0.875rem; background: #f7f5ee; border: 1px solid #e9e5d8; border-radius: 6px; }
+      .attachment .icon { font-size: 1.25rem; line-height: 1; }
+      .attachment .meta { flex: 1; }
+      .attachment .name { font-weight: 500; font-size: 0.9375rem; }
+      .attachment .size { font-size: 0.8125rem; color: var(--muted); margin-top: 0.125rem; }
+      .attachment a { color: #2563eb; text-decoration: none; font-size: 0.875rem; }
+      .attachment a:hover { text-decoration: underline; }
+      .actions { display: grid; grid-template-columns: 1fr 1fr; gap: 0.75rem; }
+      .field { margin-bottom: 1rem; }
+      label { display: block; font-size: 0.875rem; font-weight: 500; margin-bottom: 0.375rem; }
+      input, textarea { width: 100%; padding: 0.625rem 0.75rem; border: 1px solid #d4d4d4; border-radius: 6px; font: inherit; box-sizing: border-box; background: #fff; }
+      input:focus, textarea:focus { outline: 2px solid #2563eb; outline-offset: -2px; }
+      textarea { min-height: 6rem; resize: vertical; line-height: 1.5; }
+      button { width: 100%; padding: 0.75rem 1rem; border: 0; border-radius: 6px; font: inherit; font-weight: 500; cursor: pointer; }
+      button.approve { background: var(--ok); color: #fff; }
+      button.approve:hover { background: #086324; }
+      button.revise { background: #fff; color: var(--fg); border: 1px solid var(--border); }
+      button.revise:hover { background: #f7f5ee; }
+      .meta-block { font-size: 0.8125rem; color: var(--muted); padding: 0.75rem 0.875rem; background: #f5f4f0; border: 1px solid var(--border); border-radius: 6px; }
+      .meta-block dl { margin: 0; display: grid; grid-template-columns: max-content 1fr; gap: 0.25rem 0.75rem; }
+      .meta-block dt { font-weight: 500; color: #444; }
+      .meta-block dd { margin: 0; font-family: ui-monospace, SF Mono, monospace; font-size: 0.75rem; word-break: break-all; }
+      details { margin-top: 1.25rem; }
+      summary { cursor: pointer; font-size: 0.875rem; color: var(--muted); }
+      summary:hover { color: var(--fg); }
+    </style>
+  </head>
+  <body>
+    <p class="lead">{{agencyName}}{{#engagementName}} · {{engagementName}}{{/engagementName}}</p>
+    <h1>Review &amp; sign: {{deliverableTitle}}</h1>
+    {{#context}}<p style="margin:-1rem 0 1.5rem;color:var(--muted);">{{context}}</p>{{/context}}
+    {{#deliverableBodyHtml}}
+    <section class="panel body">
+      {{{deliverableBodyHtml}}}
+    </section>
+    {{/deliverableBodyHtml}}
+    {{#attachments.length}}
+    <section class="panel">
+      <h2>Attachments</h2>
+      <div class="attachments">
+        {{#attachments}}
+        <div class="attachment">
+          <span class="icon">{{icon}}</span>
+          <div class="meta">
+            <div class="name">{{name}}</div>
+            <div class="size">{{sizeFormatted}}{{#kind}} · {{kind}}{{/kind}}</div>
+          </div>
+          <a href="{{url}}" target="_blank" rel="noopener">View</a>
+        </div>
+        {{/attachments}}
+      </div>
+    </section>
+    {{/attachments.length}}
+    <section class="panel">
+      <h2>Decision</h2>
+      <div class="actions">
+        <form action="{{signUrl}}" method="POST">
+          <input type="hidden" name="nonce" value="{{nonce}}" />
+          <input type="hidden" name="artifactPath" value="{{deliverablePath}}" />
+          <input type="hidden" name="documentHash" value="{{documentHash}}" />
+          <input type="hidden" name="signer" value="{{signerKind}}:{{signerSlug}}" />
+          <input type="hidden" name="signerKind" value="{{signerKind}}" />
+          {{#signerEmail}}<input type="hidden" name="signerEmail" value="{{signerEmail}}" />{{/signerEmail}}
+          <div class="field">
+            <label for="approveName">Type your name to approve</label>
+            <input id="approveName" name="signerName" type="text" required value="{{signerName}}" autocomplete="name" />
+          </div>
+          <button type="submit" class="approve">Approve &amp; sign</button>
+        </form>
+        <form action="{{reviseUrl}}" method="POST">
+          <input type="hidden" name="nonce" value="{{nonce}}" />
+          <input type="hidden" name="artifactPath" value="{{deliverablePath}}" />
+          <input type="hidden" name="signer" value="{{signerKind}}:{{signerSlug}}" />
+          <div class="field">
+            <label for="reviseFeedback">Request revisions (what should change?)</label>
+            <textarea id="reviseFeedback" name="feedback" required></textarea>
+          </div>
+          <button type="submit" class="revise">Request revisions</button>
+        </form>
+      </div>
+    </section>
+    <details>
+      <summary>Document details</summary>
+      <div class="meta-block" style="margin-top:0.625rem;">
+        <dl>
+          <dt>Path</dt><dd>{{deliverablePath}}</dd>
+          <dt>SHA-256</dt><dd>{{documentHash}}</dd>
+        </dl>
+      </div>
+    </details>
+  </body>
+</html>

package/src/spec/canvakit-templates/agency.engagement-dashboard/template.canvakit.html ADDED Viewed

@@ -0,0 +1,191 @@
+---
+template: true
+name: agency.engagement-dashboard
+version: 1.0.0-alpha
+description: |
+  Operator-facing live dashboard for a single engagement. Reads ENGAGEMENT.md +
+  AGREEMENT.md + the deliverables/ and invoices/ folders + the tail of
+  `audit-log.jsonl`. Re-renders every 30s — the workflow updates the underlying
+  workspace files, this template just reflects state.
+  Data flow:
+    1. Workflow tool transitions ENGAGEMENT.md frontmatter (status, activeStep).
+    2. signArtifactTool / recordDeliverableTool / issueInvoiceCheckoutTool write
+       artifacts under engagements/<slug>/.
+    3. recordAuditEvent appends a hash-chained line to audit/audit-log.jsonl.
+    4. This template re-reads everything on the next refresh tick.
+  No "update the dashboard" tool call is needed — the dashboard is a *view* of
+  workspace state, not a separate persistence layer.
+author: agencies.sh
+refreshEvery: 30s
+variables:
+  engagementSlug: "2026-acme-website-redesign"
+  agencyName: "Acme Agency"
+  signUrlBase: "/g/acme/sign"
+sources:
+  engagement:
+    kind: file
+    path: "engagements/{{engagementSlug}}/ENGAGEMENT.md"
+  agreement:
+    kind: file
+    path: "engagements/{{engagementSlug}}/AGREEMENT.md"
+  deliverables:
+    kind: query
+    include: "engagements/{{engagementSlug}}/deliverables/*/DELIVERABLE.md"
+    sort: "createdAt:asc"
+    fields: ["slug", "name", "status", "requiredSignatures", "createdAt"]
+  invoices:
+    kind: query
+    include: "engagements/{{engagementSlug}}/invoices/*/INVOICE.md"
+    sort: "issuedAt:desc"
+    fields: ["invoiceNumber", "amount", "currency", "status", "issuedAt", "paidAt"]
+  audit:
+    kind: tool
+    ref: governance.audit_tail
+    params:
+      logPath: "engagements/{{engagementSlug}}/audit/audit-log.jsonl"
+      lines: 12
+---
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{engagement.name}} · Engagement</title>
+    <style>
+      :root {
+        --fg: #1a1a1a;
+        --muted: #666;
+        --bg: #faf9f7;
+        --panel: #ffffff;
+        --border: #e5e5e5;
+        --accent: #1a1a1a;
+        --ok: #0a7d30;
+        --warn: #b45309;
+        --danger: #b91c1c;
+      }
+      body { font: 15px/1.55 ui-sans-serif, system-ui, sans-serif; max-width: 64rem; margin: 0 auto; padding: 2.5rem 1.5rem; color: var(--fg); background: var(--bg); }
+      header { display: flex; justify-content: space-between; align-items: baseline; margin-bottom: 2rem; }
+      h1 { font-size: 1.625rem; letter-spacing: -0.01em; margin: 0 0 0.25rem; }
+      .lead { color: var(--muted); margin: 0; font-size: 0.9375rem; }
+      .panel { background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 1.25rem 1.5rem; margin-bottom: 1.25rem; }
+      .panel h2 { font-size: 0.8125rem; text-transform: uppercase; letter-spacing: 0.08em; color: #666; margin: 0 0 1rem; }
+      .grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 1.25rem; }
+      .grid-3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1.25rem; }
+      .stat .label { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.06em; color: #666; }
+      .stat .value { font-size: 1.75rem; font-weight: 600; letter-spacing: -0.02em; margin-top: 0.25rem; }
+      .pill { display: inline-block; padding: 0.125rem 0.5rem; border-radius: 999px; font-size: 0.75rem; font-weight: 500; line-height: 1.5; vertical-align: middle; }
+      .pill.ok { background: #e7f5eb; color: var(--ok); }
+      .pill.warn { background: #fef3c7; color: var(--warn); }
+      .pill.danger { background: #fee2e2; color: var(--danger); }
+      .pill.muted { background: #f0eee9; color: #555; }
+      table { width: 100%; border-collapse: collapse; }
+      th, td { text-align: left; padding: 0.625rem 0.75rem; border-bottom: 1px solid #efece5; vertical-align: top; }
+      th { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.06em; color: #777; font-weight: 500; }
+      td.num { text-align: right; font-variant-numeric: tabular-nums; }
+      td.mono { font-family: ui-monospace, SF Mono, monospace; font-size: 0.8125rem; color: #444; }
+      .audit { font-family: ui-monospace, SF Mono, monospace; font-size: 0.8125rem; color: #555; line-height: 1.7; }
+      .audit .row { display: grid; grid-template-columns: 9rem 7rem 1fr; gap: 0.75rem; padding: 0.25rem 0; border-bottom: 1px dashed #f0eee5; }
+      .audit .row:last-child { border-bottom: 0; }
+      .audit time { color: #888; }
+      .empty { padding: 1.25rem; text-align: center; color: var(--muted); font-size: 0.875rem; background: #f7f5f0; border-radius: 6px; }
+      a { color: #2563eb; text-decoration: none; }
+      a:hover { text-decoration: underline; }
+    </style>
+  </head>
+  <body>
+    <header>
+      <div>
+        <p class="lead">{{agencyName}} · engagement</p>
+        <h1>{{engagement.name}}</h1>
+      </div>
+      <div>
+        <span class="pill {{engagement.statusPillClass}}">{{engagement.status}}</span>
+      </div>
+    </header>
+    <div class="grid-3">
+      <div class="panel stat">
+        <p class="label">Counterparty</p>
+        <p class="value">{{engagement.counterpartyDisplayName}}</p>
+      </div>
+      <div class="panel stat">
+        <p class="label">Active step</p>
+        <p class="value">{{engagement.activeStep}}</p>
+      </div>
+      <div class="panel stat">
+        <p class="label">Procedure</p>
+        <p class="value">{{engagement.activeProcedure}}</p>
+      </div>
+    </div>
+    <section class="panel">
+      <h2>Agreement</h2>
+      <table>
+        <tbody>
+          <tr><th>Status</th><td><span class="pill {{agreement.statusPillClass}}">{{agreement.status}}</span></td></tr>
+          <tr><th>Signed by</th><td>{{agreement.signedByLabel}}</td></tr>
+          <tr><th>Document hash</th><td class="mono">{{agreement.documentHash}}</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="panel">
+      <h2>Deliverables</h2>
+      {{#deliverables.length}}
+      <table>
+        <thead><tr><th>Name</th><th>Status</th><th>Pending signatures</th><th>Created</th></tr></thead>
+        <tbody>
+          {{#deliverables}}
+          <tr>
+            <td>{{name}}</td>
+            <td><span class="pill {{statusPillClass}}">{{status}}</span></td>
+            <td>{{pendingSignatureCount}}</td>
+            <td class="mono">{{createdAt}}</td>
+          </tr>
+          {{/deliverables}}
+        </tbody>
+      </table>
+      {{/deliverables.length}}
+      {{^deliverables.length}}<div class="empty">No deliverables yet — workflow has not advanced to <code>execute</code>.</div>{{/deliverables.length}}
+    </section>
+    <section class="panel">
+      <h2>Invoices</h2>
+      {{#invoices.length}}
+      <table>
+        <thead><tr><th>Invoice #</th><th>Amount</th><th>Status</th><th>Issued</th><th>Paid</th></tr></thead>
+        <tbody>
+          {{#invoices}}
+          <tr>
+            <td class="mono">{{invoiceNumber}}</td>
+            <td class="num">{{amountFormatted}}</td>
+            <td><span class="pill {{statusPillClass}}">{{status}}</span></td>
+            <td class="mono">{{issuedAt}}</td>
+            <td class="mono">{{paidAt}}</td>
+          </tr>
+          {{/invoices}}
+        </tbody>
+      </table>
+      {{/invoices.length}}
+      {{^invoices.length}}<div class="empty">No invoices issued.</div>{{/invoices.length}}
+    </section>
+    <section class="panel">
+      <h2>Recent audit events</h2>
+      {{#audit.length}}
+      <div class="audit">
+        {{#audit}}
+        <div class="row">
+          <time>{{createdAt}}</time>
+          <span>{{action}}</span>
+          <span>{{actor}} → {{entityId}}</span>
+        </div>
+        {{/audit}}
+      </div>
+      {{/audit.length}}
+      {{^audit.length}}<div class="empty">Audit log is empty.</div>{{/audit.length}}
+    </section>
+  </body>
+</html>

package/src/spec/canvakit-templates/agency.invoice-pdf/template.canvakit.html ADDED Viewed

@@ -0,0 +1,142 @@
+---
+template: true
+name: agency.invoice-pdf
+version: 1.0.0-alpha
+description: |
+  Print-targeted invoice render. The host application reads INVOICE.md +
+  ENGAGEMENT.md + AGENCY.md (or COMPANY.md), passes the merged variables in,
+  and either inlines this HTML in an email or feeds it through a PDF engine
+  (Chromium / wkhtmltopdf) to archive a frozen PDF alongside the .md.
+  Document integrity: the issuing tool computes SHA-256 of the rendered HTML
+  *before* PDF conversion and stores it in INVOICE.md frontmatter as
+  `documentHash`. A signature.json on the invoice references the same hash —
+  changing the rendered HTML invalidates the signature.
+author: agencies.sh
+variables:
+  agencyName: "Acme Agency"
+  agencyAddressHtml: ""
+  agencyTaxId: ""
+  invoiceNumber: "INV-2026-0001"
+  issuedAt: "2026-04-26"
+  dueAt: "2026-05-26"
+  status: "issued"
+  counterpartyDisplayName: "Counterparty"
+  counterpartyAddressHtml: ""
+  counterpartyTaxId: ""
+  currency: "EUR"
+  subtotalFormatted: "0.00"
+  taxLines: []
+  totalFormatted: "0.00"
+  amountDueFormatted: "0.00"
+  paymentTermsHtml: ""
+  notesHtml: ""
+  paymentLinkUrl: ""
+  lineItems: []
+sources: {}
+---
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Invoice {{invoiceNumber}}</title>
+    <style>
+      @page { size: A4; margin: 18mm; }
+      :root {
+        --fg: #111;
+        --muted: #555;
+        --border: #d4d4d4;
+        --accent: #1a1a1a;
+      }
+      body { font: 11pt/1.5 ui-sans-serif, system-ui, sans-serif; color: var(--fg); margin: 0; padding: 0; }
+      .doc { max-width: 720px; margin: 0 auto; padding: 0; }
+      header { display: flex; justify-content: space-between; align-items: flex-start; padding-bottom: 1.5rem; border-bottom: 2px solid var(--accent); margin-bottom: 2rem; }
+      .agency { max-width: 60%; }
+      .agency h1 { font-size: 1.375rem; margin: 0 0 0.25rem; letter-spacing: -0.01em; }
+      .agency .tax { color: var(--muted); font-size: 0.875rem; }
+      .doc-title { text-align: right; }
+      .doc-title h2 { font-size: 1.125rem; text-transform: uppercase; letter-spacing: 0.1em; margin: 0 0 0.25rem; color: var(--muted); font-weight: 500; }
+      .doc-title .num { font-size: 1.375rem; font-weight: 600; font-family: ui-monospace, SF Mono, monospace; }
+      .meta { display: grid; grid-template-columns: repeat(2, 1fr); gap: 1.25rem; margin-bottom: 2rem; }
+      .meta h3 { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--muted); margin: 0 0 0.375rem; font-weight: 600; }
+      .meta p { margin: 0; line-height: 1.45; }
+      .dates { display: flex; gap: 2rem; padding: 0.75rem 1rem; background: #f7f5ee; border-radius: 4px; margin-bottom: 2rem; font-size: 0.9375rem; }
+      .dates dt { font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--muted); margin-bottom: 0.125rem; }
+      .dates dd { margin: 0; font-weight: 500; }
+      table.lines { width: 100%; border-collapse: collapse; margin-bottom: 1.5rem; }
+      table.lines th { text-align: left; font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--muted); padding: 0.5rem 0.75rem; border-bottom: 2px solid var(--accent); font-weight: 600; }
+      table.lines td { padding: 0.625rem 0.75rem; border-bottom: 1px solid #efefef; vertical-align: top; }
+      table.lines td.num { text-align: right; font-variant-numeric: tabular-nums; }
+      .totals { margin-left: auto; width: 18rem; font-size: 0.9375rem; }
+      .totals .row { display: flex; justify-content: space-between; padding: 0.375rem 0; }
+      .totals .row.grand { border-top: 2px solid var(--accent); margin-top: 0.5rem; padding-top: 0.625rem; font-weight: 600; font-size: 1.0625rem; }
+      .totals .row.due { color: var(--accent); margin-top: 0.5rem; padding: 0.625rem 0.75rem; background: #f7f5ee; border-radius: 4px; font-weight: 600; }
+      footer { margin-top: 2.5rem; padding-top: 1.25rem; border-top: 1px solid var(--border); font-size: 0.875rem; color: var(--muted); line-height: 1.55; }
+      .pay-link { display: inline-block; margin-top: 0.75rem; padding: 0.5rem 1rem; background: var(--accent); color: #fff; text-decoration: none; border-radius: 4px; font-weight: 500; font-size: 0.875rem; }
+      .pill { display: inline-block; padding: 0.125rem 0.625rem; border-radius: 999px; font-size: 0.75rem; font-weight: 500; background: #f0eee5; color: #555; vertical-align: middle; margin-left: 0.5rem; }
+    </style>
+  </head>
+  <body>
+    <div class="doc">
+      <header>
+        <div class="agency">
+          <h1>{{agencyName}}</h1>
+          {{{agencyAddressHtml}}}
+          {{#agencyTaxId}}<p class="tax">Tax ID: {{agencyTaxId}}</p>{{/agencyTaxId}}
+        </div>
+        <div class="doc-title">
+          <h2>Invoice <span class="pill">{{status}}</span></h2>
+          <div class="num">{{invoiceNumber}}</div>
+        </div>
+      </header>
+      <section class="meta">
+        <div>
+          <h3>Bill to</h3>
+          <p><strong>{{counterpartyDisplayName}}</strong></p>
+          {{{counterpartyAddressHtml}}}
+          {{#counterpartyTaxId}}<p class="tax">Tax ID: {{counterpartyTaxId}}</p>{{/counterpartyTaxId}}
+        </div>
+        <div class="dates">
+          <div><dt>Issued</dt><dd>{{issuedAt}}</dd></div>
+          <div><dt>Due</dt><dd>{{dueAt}}</dd></div>
+        </div>
+      </section>
+      <table class="lines">
+        <thead>
+          <tr><th>Description</th><th class="num">Qty</th><th class="num">Unit</th><th class="num">Total</th></tr>
+        </thead>
+        <tbody>
+          {{#lineItems}}
+          <tr>
+            <td>{{description}}</td>
+            <td class="num">{{quantity}}</td>
+            <td class="num">{{unitPriceFormatted}}</td>
+            <td class="num">{{totalFormatted}}</td>
+          </tr>
+          {{/lineItems}}
+        </tbody>
+      </table>
+      <div class="totals">
+        <div class="row"><span>Subtotal</span><span>{{subtotalFormatted}} {{currency}}</span></div>
+        {{#taxLines}}
+        <div class="row"><span>{{label}}</span><span>{{amountFormatted}} {{currency}}</span></div>
+        {{/taxLines}}
+        <div class="row grand"><span>Total</span><span>{{totalFormatted}} {{currency}}</span></div>
+        <div class="row due"><span>Amount due</span><span>{{amountDueFormatted}} {{currency}}</span></div>
+      </div>
+      {{#paymentLinkUrl}}
+      <p style="text-align:right;margin-top:1.25rem;"><a class="pay-link" href="{{paymentLinkUrl}}">Pay online</a></p>
+      {{/paymentLinkUrl}}
+      <footer>
+        {{#paymentTermsHtml}}<div>{{{paymentTermsHtml}}}</div>{{/paymentTermsHtml}}
+        {{#notesHtml}}<div style="margin-top:0.75rem;">{{{notesHtml}}}</div>{{/notesHtml}}
+        <p style="margin-top:1rem;font-size:0.75rem;">Generated by {{agencyName}} · agentagencies/v1</p>
+      </footer>
+    </div>
+  </body>
+</html>