archsutra-ai 0.1.2 → 0.1.4

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 (60) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +25 -17
  3. package/dist/audit.js +5 -2
  4. package/dist/cli.js +116 -12
  5. package/dist/drift.js +57 -0
  6. package/dist/imports.js +42 -0
  7. package/dist/map.js +13 -1
  8. package/dist/mcp.js +81 -0
  9. package/dist/scaffold.js +87 -0
  10. package/dist/suppress.js +51 -0
  11. package/docs/architecture/overview.html +3 -3
  12. package/docs/architecture/threat-model.html +3 -3
  13. package/docs/community/good-first-issues.html +3 -3
  14. package/docs/compatibility/matrix.html +3 -3
  15. package/docs/compatibility/smoke-tests/index.html +3 -3
  16. package/docs/compatibility/smoke-tests/results-2026-11-07.md +17 -0
  17. package/docs/decisions/ADR-0001-deterministic-cli-plus-ide-skills.html +3 -3
  18. package/docs/handbook/01-executive-summary.html +5 -5
  19. package/docs/handbook/01-executive-summary.md +2 -2
  20. package/docs/handbook/02-functional-specification.html +5 -5
  21. package/docs/handbook/02-functional-specification.md +2 -2
  22. package/docs/handbook/03-technical-specification.html +4 -4
  23. package/docs/handbook/03-technical-specification.md +1 -1
  24. package/docs/handbook/04-architecture.html +4 -4
  25. package/docs/handbook/04-architecture.md +1 -1
  26. package/docs/handbook/05-user-guide.html +6 -6
  27. package/docs/handbook/05-user-guide.md +3 -3
  28. package/docs/handbook/06-cli-reference.html +5 -5
  29. package/docs/handbook/06-cli-reference.md +9 -2
  30. package/docs/handbook/07-security-privacy-legal.html +4 -4
  31. package/docs/handbook/07-security-privacy-legal.md +1 -1
  32. package/docs/handbook/08-testing-and-proof.html +5 -5
  33. package/docs/handbook/08-testing-and-proof.md +2 -2
  34. package/docs/handbook/09-compatibility-and-roadmap.html +11 -11
  35. package/docs/handbook/09-compatibility-and-roadmap.md +25 -14
  36. package/docs/handbook/10-contributor-guide.html +4 -4
  37. package/docs/handbook/10-contributor-guide.md +3 -3
  38. package/docs/handbook/11-glossary-and-faq.html +4 -4
  39. package/docs/handbook/11-glossary-and-faq.md +1 -1
  40. package/docs/handbook/12-rule-catalog.html +3 -3
  41. package/docs/handbook/13-trust-and-assurance.html +5 -5
  42. package/docs/handbook/13-trust-and-assurance.md +3 -3
  43. package/docs/handbook/14-real-world-evaluation.html +3 -3
  44. package/docs/handbook/15-supply-chain-and-release.html +5 -5
  45. package/docs/handbook/15-supply-chain-and-release.md +7 -5
  46. package/docs/handbook/16-performance-and-quality-metrics.html +4 -4
  47. package/docs/handbook/16-performance-and-quality-metrics.md +1 -1
  48. package/docs/handbook/README.md +2 -2
  49. package/docs/handbook/index.html +5 -5
  50. package/docs/index.html +4 -4
  51. package/docs/legal/legal-review-brief.html +3 -3
  52. package/docs/legal/trademark-and-name-clearance.html +5 -5
  53. package/docs/legal/trademark-and-name-clearance.md +3 -1
  54. package/docs/proof/accessibility.html +3 -3
  55. package/docs/proof/test-results.txt +40 -35
  56. package/docs/rfc/0001-archsutra-v0.1.html +5 -5
  57. package/docs/rfc/0001-archsutra-v0.1.md +2 -2
  58. package/docs/sitemap.xml +28 -28
  59. package/llms.txt +6 -3
  60. package/package.json +7 -3
@@ -10,8 +10,8 @@ An independent-style review of this project listed 15 gaps that stop people from
10
10
  | 2 | Live proof in AI IDEs | **Pending** | Layouts checked against vendor docs on 2026-11-01; protocol and empty results log: [smoke tests](../compatibility/smoke-tests/README.md). Needs the owner or community with access to each IDE |
11
11
  | 3 | Head-to-head comparison | **Pending** | Workflow and script ready ([`comparison.yml`](../../.github/workflows/comparison.yml), `scripts/compare.mjs`); first run needs the repository on GitHub with Actions. A plain-AI-prompt comparison is deliberately not offered (not reproducible) |
12
12
  | 4 | CI confirmed on all platforms | **Partly** | Ubuntu and Windows pass (Node 20, 22, 24, plus Ubuntu on the newest Node). macOS is not in CI: GitHub cancelled those jobs before a runner started, and there is no Mac available to re-check. Dependabot is limited and grouped to stop queue floods |
13
- | 5 | Signed releases, provenance, SBOM | **Partly** | Release workflow builds the tarball, CycloneDX SBOMs, SHA-256 checksums and a signed build-provenance attestation on every tag ([supply chain](15-supply-chain-and-release.md)). First attested release has not happened yet; not published to npm |
14
- | 6 | OpenSSF Scorecard | **Partly** | [Workflow](../../.github/workflows/scorecard.yml) added (publishes results and SARIF). No score exists until it runs on GitHub; do not quote one |
13
+ | 5 | Signed releases, provenance, SBOM | **Partly** | GitHub release `v0.1.2` has the tarball, two CycloneDX SBOMs, `SHA256SUMS`, and 2 GitHub attestations on digest `sha256:4a7f9124501f646dad77799e5c0d3ed6533b9884775904285bc050f77c989018`. Scorecard Signed-Releases still scores 0 and does not credit those attestations. npm `archsutra-ai@0.1.2` and `@0.1.3` are published from a laptop: no npm provenance, no `v0.1.3` tag, and `0.1.3` `gitHead` is `4a7ab27` (a commit whose `package.json` is still 0.1.2) |
14
+ | 6 | OpenSSF Scorecard | **Partly** | Public score **5.7 / 10** on 2026-11-06 for commit `06c87c4` (Scorecard v5.6.0). Checks at 10 include Security-Policy, Binary-Artifacts, Dependency-Update-Tool, SAST, Token-Permissions, Dangerous-Workflow, Vulnerabilities, and License. Zeros: Branch-Protection, Code-Review, Signed-Releases, Maintained (repository younger than 90 days), CII-Best-Practices, Fuzzing, Contributors. Packaging is -1 (no Actions npm publish). Pinned-Dependencies is 7 (fixture Dockerfiles and the Semgrep pip install are not hash-pinned). CI-Tests is -1 because Scorecard saw no pull request; tests do run on push |
15
15
  | 7 | Pinned install and pinned actions | **Done** | README and user guide show tag-pinned `npx` usage; every GitHub Action in all workflows is pinned to a commit SHA with a version comment, kept fresh by Dependabot |
16
16
  | 8 | Performance data | **Done** | [Benchmarks](../proof/benchmarks.md) (synthetic, 200 to 20 000 files) and real-repository timings in `docs/proof/realworld/results*.json`. Found and fixed a gap: added a total-bytes budget and cache cap so memory is bounded |
17
17
  | 9 | Test coverage | **Done** | 92% lines, 81% branches, 91% functions over `dist/` ([report](../proof/coverage.txt)); CI prints coverage on every run. No threshold is enforced yet |
@@ -24,7 +24,7 @@ An independent-style review of this project listed 15 gaps that stop people from
24
24
 
25
25
  ## What a reader can verify in five minutes
26
26
 
27
- 1. `git clone` and `npm ci && npm test` (31 tests).
27
+ 1. `git clone` and `npm ci && npm test` (36 tests).
28
28
  2. `node scripts/realworld.mjs report holdout2` reproduces the headline accuracy table from the committed samples and labels.
29
29
  3. Read ten labels in `docs/proof/realworld/labels-holdout2.json` and open the cited lines.
30
30
  4. `npm ls --omit=dev` shows no runtime dependencies.
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Real-world evaluation","description":"How ArchSutra's findings were measured on 52 public repositories, the honest results, what was fixed because of them, and the limits.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Real-world evaluation","description":"How ArchSutra's findings were measured on 52 public repositories, the honest results, what was fixed because of them, and the limits.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,7 +34,7 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html" aria-current="page">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Handbook</p><h1 id="real-world-evaluation">Real-world evaluation</h1>
37
- <p class="lede">How ArchSutra's findings were measured on 52 public repositories, the honest results, what was fixed because of them, and the limits.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/14-real-world-evaluation.md" rel="noopener">docs/handbook/14-real-world-evaluation.md</a></p>
37
+ <p class="lede">How ArchSutra's findings were measured on 52 public repositories, the honest results, what was fixed because of them, and the limits.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/14-real-world-evaluation.md" rel="noopener">docs/handbook/14-real-world-evaluation.md</a></p>
38
38
  <p>This is the evidence behind the accuracy claims. It replaces the earlier fixture-only numbers, which were a regression guarantee and not an accuracy estimate.</p>
39
39
  <h2 id="summary">Summary<a class="anchor" href="#summary" aria-label="Link to this section">#</a></h2>
40
40
  <div class="table-wrap" tabindex="0" role="region" aria-label="Table 1: Summary"><table><thead><tr><th scope="col">Batch</th><th scope="col">Purpose</th><th scope="col">Repos</th><th scope="col">Findings</th><th scope="col">Sampled and labeled</th><th scope="col">Precision (95% CI)</th><th scope="col">Actionable (95% CI)</th></tr></thead><tbody><tr><td>tuning, <strong>v0.1.0 baseline</strong></td><td>find problems</td><td>24</td><td>91</td><td>48</td><td><strong>50%</strong> (36 to 64)</td><td>29% (18 to 43)</td></tr><tr><td>holdout, after round-1 fixes</td><td>first unseen test</td><td>14</td><td>48</td><td>29</td><td><strong>69%</strong> (51 to 83)</td><td>34% (20 to 53)</td></tr><tr><td>holdout2, after round-2 fixes</td><td>final unseen test</td><td>14</td><td>40</td><td>21</td><td><strong>95%</strong> (77 to 99)</td><td>52% (32 to 72)</td></tr></tbody></table></div>
@@ -68,7 +68,7 @@ node scripts/labeled-recall.mjs &quot;$TMPDIR/rw&quot;</code></pre></div>
68
68
  </div>
69
69
  <footer class="footer">
70
70
  <div class="footer-inner">
71
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
71
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
72
72
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
73
73
  </div>
74
74
  </footer>
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Supply chain and release","description":"How releases are built, signed and attested, how to verify them, and which supply-chain controls exist.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Supply chain and release","description":"How releases are built, signed and attested, how to verify them, and which supply-chain controls exist.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,7 +34,7 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html" aria-current="page">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Handbook</p><h1 id="supply-chain-and-release">Supply chain and release</h1>
37
- <p class="lede">How releases are built, signed and attested, how to verify them, and which supply-chain controls exist.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/15-supply-chain-and-release.md" rel="noopener">docs/handbook/15-supply-chain-and-release.md</a></p>
37
+ <p class="lede">How releases are built, signed and attested, how to verify them, and which supply-chain controls exist.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/15-supply-chain-and-release.md" rel="noopener">docs/handbook/15-supply-chain-and-release.md</a></p>
38
38
  <h2 id="controls">Controls<a class="anchor" href="#controls" aria-label="Link to this section">#</a></h2>
39
39
  <div class="table-wrap" tabindex="0" role="region" aria-label="Table 1: Controls"><table><thead><tr><th scope="col">Control</th><th scope="col">Where</th><th scope="col">Status</th></tr></thead><tbody><tr><td>Zero runtime dependencies</td><td><code>package.json</code>; CI step <code>npm ls --omit=dev</code></td><td>enforced in CI</td></tr><tr><td>Lockfile and clean installs</td><td><code>package-lock.json</code>; CI uses <code>npm ci</code></td><td>enforced</td></tr><tr><td>GitHub Actions pinned to commit SHAs</td><td>all files in <code>.github/workflows/</code> (version in a comment)</td><td>done</td></tr><tr><td>Least-privilege workflow permissions</td><td><code>permissions: contents: read</code> by default; elevated only per job</td><td>done</td></tr><tr><td>Dependency updates</td><td>Dependabot (weekly, grouped, major TypeScript and Node typings bumps ignored)</td><td>configured</td></tr><tr><td>Static analysis</td><td>CodeQL (JavaScript/TypeScript) on push, PR and weekly</td><td>configured</td></tr><tr><td>Project health score</td><td>OpenSSF Scorecard workflow, results published</td><td>configured; no score yet</td></tr><tr><td>Developer Certificate of Origin</td><td>CI job <code>dco</code> on pull requests</td><td>configured</td></tr><tr><td>SBOM</td><td>CycloneDX JSON for production and full dependency sets, attached to each release</td><td>on release</td></tr><tr><td>Checksums</td><td><code>SHA256SUMS</code> over the tarball and SBOMs</td><td>on release</td></tr><tr><td>Build provenance attestation</td><td><code>actions/attest</code> signs the tarball with GitHub's Sigstore-based keyless signing</td><td>on release</td></tr><tr><td>Secret scanning</td><td>GitHub secret scanning and push protection (public repositories); our own audit finds no secrets in the tree</td><td>enabled by GitHub</td></tr><tr><td>Vulnerability reporting</td><td>GitHub private advisories; <code>security.txt</code></td><td>configured</td></tr></tbody></table></div>
40
40
  <h2 id="release-procedure">Release procedure<a class="anchor" href="#release-procedure" aria-label="Link to this section">#</a></h2>
@@ -45,14 +45,14 @@ sha256sum -c SHA256SUMS
45
45
  gh attestation verify archsutra-ai-X.Y.Z.tgz --repo shahvatsalofficial/archsutra-ai</code></pre></div>
46
46
  <p>A successful <code>gh attestation verify</code> proves the tarball was built by the repository's <code>Release</code> workflow at the tagged commit.</p>
47
47
  <h2 id="using-the-tool-safely">Using the tool safely<a class="anchor" href="#using-the-tool-safely" aria-label="Link to this section">#</a></h2>
48
- <ul><li>Prefer a pinned reference, not the moving default branch: ``<code>bash npx github:shahvatsalofficial/archsutra-ai#v0.1.2 audit . --output docs/architecture </code>`<code> Even better, pin a full commit SHA: </code>npx github:shahvatsalofficial/archsutra-ai#&lt;40-char sha&gt; audit .`.</li><li><code>npx github:...</code> builds from source on your machine (<code>prepare</code> runs <code>tsc</code>); that requires the dev dependencies (TypeScript) to be installed during the build, which come from the lockfile.</li><li>The release tarball can be inspected before running: <code>tar -tzf archsutra-ai-X.Y.Z.tgz</code>.</li></ul>
48
+ <ul><li>Prefer a pinned release, not the moving default branch. ``<code>bash npx --yes archsutra-ai@0.1.3 audit . --output docs/architecture </code>`<code> Use </code>@0.1.3<code> on Windows. </code>0.1.2<code> installs a command named </code>archsutra<code> only, so </code>npx archsutra-ai<code> fails there with </code>'archsutra' is not recognized`.</li><li>The git tag <code>v0.1.2</code> is the attested GitHub release (tarball, SBOMs, checksums, 2 attestations). It does not contain the <code>archsutra-ai</code> bin. There is no <code>v0.1.3</code> tag. npm <code>0.1.3</code> reports <code>gitHead</code> <code>4a7ab2768c7875fedaeffcffcab18211789efd88</code>, which is not the commit that contains version <code>0.1.3</code> in git, and it has no npm provenance.</li><li>A full commit SHA is still the tightest git pin: <code>npx github:shahvatsalofficial/archsutra-ai#&lt;40-char sha&gt; audit .</code>. Pin a commit at or after the Windows bin fix, not <code>v0.1.2</code>, if the command you run is <code>archsutra-ai</code>.</li><li><code>npx github:...</code> builds from source on your machine (<code>prepare</code> runs <code>tsc</code>); that requires the dev dependencies (TypeScript) to be installed during the build, which come from the lockfile.</li><li>The release tarball can be inspected before running: <code>tar -tzf archsutra-ai-X.Y.Z.tgz</code>.</li></ul>
49
49
  <h2 id="not-yet-done">Not yet done<a class="anchor" href="#not-yet-done" aria-label="Link to this section">#</a></h2>
50
- <div class="table-wrap" tabindex="0" role="region" aria-label="Table 2: Not yet done"><table><thead><tr><th scope="col">Item</th><th scope="col">Why</th></tr></thead><tbody><tr><td>Publish to npm</td><td>Needs an npm account and a name decision; then use <code>npm publish --provenance</code> from the release workflow</td></tr><tr><td>Signed git tags</td><td>Needs the maintainer's signing key</td></tr><tr><td>Reproducible build verification</td><td>The TypeScript build is deterministic in practice but not independently verified</td></tr><tr><td>SLSA level claim</td><td>Provenance exists only after the first tagged release; no level is claimed</td></tr></tbody></table></div></article></main>
50
+ <div class="table-wrap" tabindex="0" role="region" aria-label="Table 2: Not yet done"><table><thead><tr><th scope="col">Item</th><th scope="col">Why</th></tr></thead><tbody><tr><td>npm publish from GitHub Actions with provenance</td><td><code>release.yml</code> runs <code>npm publish --provenance --access public</code> on a version tag. npm must have a trusted publisher for this repository and <code>release.yml</code>, or the step fails. <code>0.1.2</code> and <code>0.1.3</code> were laptop publishes and cannot be replaced</td></tr><tr><td>Signed git tags</td><td>Needs the maintainer's signing key</td></tr><tr><td>Reproducible build verification</td><td>The TypeScript build is deterministic in practice but not independently verified</td></tr><tr><td>SLSA level claim</td><td><code>v0.1.2</code> has GitHub attestations. Scorecard Signed-Releases still scores 0. No SLSA level is claimed</td></tr></tbody></table></div></article></main>
51
51
  <aside class="rail"><nav class="toc" aria-label="On this page"><p class="nav-title">On this page</p><ul><li class="l2"><a href="#controls">Controls</a></li><li class="l2"><a href="#release-procedure">Release procedure</a></li><li class="l2"><a href="#verify-a-release">Verify a release</a></li><li class="l2"><a href="#using-the-tool-safely">Using the tool safely</a></li><li class="l2"><a href="#not-yet-done">Not yet done</a></li></ul></nav></aside>
52
52
  </div>
53
53
  <footer class="footer">
54
54
  <div class="footer-inner">
55
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
55
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
56
56
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
57
57
  </div>
58
58
  </footer>
@@ -45,11 +45,13 @@ A successful `gh attestation verify` proves the tarball was built by the reposit
45
45
 
46
46
  ## Using the tool safely
47
47
 
48
- - Prefer a pinned reference, not the moving default branch:
48
+ - Prefer a pinned release, not the moving default branch.
49
49
  ```bash
50
- npx github:shahvatsalofficial/archsutra-ai#v0.1.2 audit . --output docs/architecture
50
+ npx --yes archsutra-ai@0.1.3 audit . --output docs/architecture
51
51
  ```
52
- Even better, pin a full commit SHA: `npx github:shahvatsalofficial/archsutra-ai#<40-char sha> audit .`.
52
+ Use `@0.1.3` on Windows. `0.1.2` installs a command named `archsutra` only, so `npx archsutra-ai` fails there with `'archsutra' is not recognized`.
53
+ - The git tag `v0.1.2` is the attested GitHub release (tarball, SBOMs, checksums, 2 attestations). It does not contain the `archsutra-ai` bin. There is no `v0.1.3` tag. npm `0.1.3` reports `gitHead` `4a7ab2768c7875fedaeffcffcab18211789efd88`, which is not the commit that contains version `0.1.3` in git, and it has no npm provenance.
54
+ - A full commit SHA is still the tightest git pin: `npx github:shahvatsalofficial/archsutra-ai#<40-char sha> audit .`. Pin a commit at or after the Windows bin fix, not `v0.1.2`, if the command you run is `archsutra-ai`.
53
55
  - `npx github:...` builds from source on your machine (`prepare` runs `tsc`); that requires the dev dependencies (TypeScript) to be installed during the build, which come from the lockfile.
54
56
  - The release tarball can be inspected before running: `tar -tzf archsutra-ai-X.Y.Z.tgz`.
55
57
 
@@ -57,7 +59,7 @@ A successful `gh attestation verify` proves the tarball was built by the reposit
57
59
 
58
60
  | Item | Why |
59
61
  |---|---|
60
- | Publish to npm | Needs an npm account and a name decision; then use `npm publish --provenance` from the release workflow |
62
+ | npm publish from GitHub Actions with provenance | `release.yml` runs `npm publish --provenance --access public` on a version tag. npm must have a trusted publisher for this repository and `release.yml`, or the step fails. `0.1.2` and `0.1.3` were laptop publishes and cannot be replaced |
61
63
  | Signed git tags | Needs the maintainer's signing key |
62
64
  | Reproducible build verification | The TypeScript build is deterministic in practice but not independently verified |
63
- | SLSA level claim | Provenance exists only after the first tagged release; no level is claimed |
65
+ | SLSA level claim | `v0.1.2` has GitHub attestations. Scorecard Signed-Releases still scores 0. No SLSA level is claimed |
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Performance and quality metrics","description":"Measured speed, memory, test coverage and robustness checks, with the exact commands and caveats.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Performance and quality metrics","description":"Measured speed, memory, test coverage and robustness checks, with the exact commands and caveats.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,7 +34,7 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html" aria-current="page">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Handbook</p><h1 id="performance-and-quality-metrics">Performance and quality metrics</h1>
37
- <p class="lede">Measured speed, memory, test coverage and robustness checks, with the exact commands and caveats.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/16-performance-and-quality-metrics.md" rel="noopener">docs/handbook/16-performance-and-quality-metrics.md</a></p>
37
+ <p class="lede">Measured speed, memory, test coverage and robustness checks, with the exact commands and caveats.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/16-performance-and-quality-metrics.md" rel="noopener">docs/handbook/16-performance-and-quality-metrics.md</a></p>
38
38
  <p>All numbers are measured, reproducible, and from a developer laptop (Windows 11), so absolute timings are pessimistic compared with Linux CI because of slower file-system access and antivirus scanning.</p>
39
39
  <h2 id="speed-and-memory-synthetic-repositories">Speed and memory (synthetic repositories)<a class="anchor" href="#speed-and-memory-synthetic-repositories" aria-label="Link to this section">#</a></h2>
40
40
  <p>Generated by <code>node scripts/bench.mjs</code> into <a href="../proof/benchmarks.md"><code>docs/proof/benchmarks.md</code></a>. Each case runs in a fresh process so peak memory is meaningful.</p>
@@ -51,12 +51,12 @@
51
51
  <h2 id="robustness-checks-in-the-test-suite">Robustness checks in the test suite<a class="anchor" href="#robustness-checks-in-the-test-suite" aria-label="Link to this section">#</a></h2>
52
52
  <div class="table-wrap" tabindex="0" role="region" aria-label="Table 4: Robustness checks in the test suite"><table><thead><tr><th scope="col">Check</th><th scope="col">Test</th></tr></thead><tbody><tr><td>Pathological and very long lines finish under 3 s (ReDoS guard)</td><td><code>adversarial inputs: long and pathological lines ...</code></td></tr><tr><td>Hostile file names, binary content, bidi characters never crash or execute</td><td><code>hostile file names and binary content ...</code></td></tr><tr><td>Path traversal rejected</td><td><code>safeJoin rejects traversal</code>, <code>export ... blocks escaping --output</code></td></tr><tr><td>Symlinks not followed</td><td><code>walk does not follow symlinks</code></td></tr><tr><td>Secrets never appear in output</td><td><code>redact ...</code>, <code>audit finds seeded problems ...</code></td></tr><tr><td>Total-byte budget reported as truncation</td><td><code>total-bytes budget truncates and reports it</code></td></tr></tbody></table></div>
53
53
  <h2 id="quality-gates-in-ci">Quality gates in CI<a class="anchor" href="#quality-gates-in-ci" aria-label="Link to this section">#</a></h2>
54
- <p>Typecheck (strict TypeScript), 31 tests on Ubuntu and Windows across Node 20, 22 and 24 (plus Ubuntu on the newest Node), structural verification of skills, agents, links and diagrams, a self-audit with <code>--fail-on high</code>, a production-dependency check, CodeQL, and (on pull requests) the DCO check. macOS is not in CI.</p></article></main>
54
+ <p>Typecheck (strict TypeScript), 36 tests on Ubuntu and Windows across Node 20, 22 and 24 (plus Ubuntu on the newest Node), structural verification of skills, agents, links and diagrams, a self-audit with <code>--fail-on high</code>, a production-dependency check, CodeQL, and (on pull requests) the DCO check. macOS is not in CI.</p></article></main>
55
55
  <aside class="rail"><nav class="toc" aria-label="On this page"><p class="nav-title">On this page</p><ul><li class="l2"><a href="#speed-and-memory-synthetic-repositories">Speed and memory (synthetic repositories)</a></li><li class="l2"><a href="#speed-on-real-repositories">Speed on real repositories</a></li><li class="l2"><a href="#bounds-why-runtime-is-limited">Bounds (why runtime is limited)</a></li><li class="l2"><a href="#test-coverage">Test coverage</a></li><li class="l2"><a href="#robustness-checks-in-the-test-suite">Robustness checks in the test suite</a></li><li class="l2"><a href="#quality-gates-in-ci">Quality gates in CI</a></li></ul></nav></aside>
56
56
  </div>
57
57
  <footer class="footer">
58
58
  <div class="footer-inner">
59
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
59
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
60
60
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
61
61
  </div>
62
62
  </footer>
@@ -57,4 +57,4 @@ Weakest areas: CLI argument-error branches and rarely used `verify` branches. CI
57
57
 
58
58
  ## Quality gates in CI
59
59
 
60
- Typecheck (strict TypeScript), 31 tests on Ubuntu and Windows across Node 20, 22 and 24 (plus Ubuntu on the newest Node), structural verification of skills, agents, links and diagrams, a self-audit with `--fail-on high`, a production-dependency check, CodeQL, and (on pull requests) the DCO check. macOS is not in CI.
60
+ Typecheck (strict TypeScript), 36 tests on Ubuntu and Windows across Node 20, 22 and 24 (plus Ubuntu on the newest Node), structural verification of skills, agents, links and diagrams, a self-audit with `--fail-on high`, a production-dependency check, CodeQL, and (on pull requests) the DCO check. macOS is not in CI.
@@ -2,7 +2,7 @@
2
2
 
3
3
  <!-- summary: Start here. Map of every document, who it is for, and the facts that never change. -->
4
4
 
5
- This handbook is the complete reference for **ArchSutra AI** (v0.1.2): what it is, what it does, how it is built, how to use it, how far you can trust it, and where it is going. It is written so that a new engineer, an executive, an auditor, or a future maintainer can understand the whole system without asking anyone.
5
+ This handbook is the complete reference for **ArchSutra AI** (v0.1.3): what it is, what it does, how it is built, how to use it, how far you can trust it, and where it is going. It is written so that a new engineer, an executive, an auditor, or a future maintainer can understand the whole system without asking anyone.
6
6
 
7
7
  > **One-sentence summary.** ArchSutra AI is an open-source set of portable Agent Skills and a deterministic, offline CLI that give AI coding assistants (Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI) an evidence-first way to design, audit, threat-model and modernize software architecture, with no extra API key.
8
8
 
@@ -46,7 +46,7 @@ Also: [Live smoke tests](../compatibility/smoke-tests/README.md), [Accessibility
46
46
  | Item | Value |
47
47
  |---|---|
48
48
  | Version | 0.1.2 |
49
- | Creator | Vatsal Shah ([@shahvatsalofficial](https://github.com/shahvatsalofficial)) |
49
+ | Creator | [Vatsal Shah](https://shahvatsal.com) |
50
50
  | License | Apache-2.0 |
51
51
  | Language / runtime | TypeScript (strict, ESM), Node.js 20+ |
52
52
  | Runtime dependencies | 0 |
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"ArchSutra AI Handbook","description":"Start here. Map of every document, who it is for, and the facts that never change.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"ArchSutra AI Handbook","description":"Start here. Map of every document, who it is for, and the facts that never change.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,8 +34,8 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html" aria-current="page">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Handbook</p><h1 id="archsutra-ai-handbook">ArchSutra AI Handbook</h1>
37
- <p class="lede">Start here. Map of every document, who it is for, and the facts that never change.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/README.md" rel="noopener">docs/handbook/README.md</a></p>
38
- <p>This handbook is the complete reference for <strong>ArchSutra AI</strong> (v0.1.2): what it is, what it does, how it is built, how to use it, how far you can trust it, and where it is going. It is written so that a new engineer, an executive, an auditor, or a future maintainer can understand the whole system without asking anyone.</p>
37
+ <p class="lede">Start here. Map of every document, who it is for, and the facts that never change.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/handbook/README.md" rel="noopener">docs/handbook/README.md</a></p>
38
+ <p>This handbook is the complete reference for <strong>ArchSutra AI</strong> (v0.1.3): what it is, what it does, how it is built, how to use it, how far you can trust it, and where it is going. It is written so that a new engineer, an executive, an auditor, or a future maintainer can understand the whole system without asking anyone.</p>
39
39
  <blockquote><strong>One-sentence summary.</strong> ArchSutra AI is an open-source set of portable Agent Skills and a deterministic, offline CLI that give AI coding assistants (Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI) an evidence-first way to design, audit, threat-model and modernize software architecture, with no extra API key.</blockquote>
40
40
  <h2 id="choose-your-path">Choose your path<a class="anchor" href="#choose-your-path" aria-label="Link to this section">#</a></h2>
41
41
  <div class="table-wrap" tabindex="0" role="region" aria-label="Table 1: Choose your path"><table><thead><tr><th scope="col">You are</th><th scope="col">Read first</th><th scope="col">Then</th></tr></thead><tbody><tr><td>Executive or sponsor</td><td><a href="01-executive-summary.html">Executive summary</a></td><td><a href="13-trust-and-assurance.html">Trust and assurance</a>, <a href="07-security-privacy-legal.html">Security, privacy and legal</a>, <a href="09-compatibility-and-roadmap.html">Roadmap</a></td></tr><tr><td>Product or functional owner</td><td><a href="02-functional-specification.html">Functional specification</a></td><td><a href="05-user-guide.html">User guide</a></td></tr><tr><td>Architect</td><td><a href="04-architecture.html">Architecture</a></td><td><a href="03-technical-specification.html">Technical specification</a>, <a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADRs</a></td></tr><tr><td>Developer or contributor</td><td><a href="03-technical-specification.html">Technical specification</a></td><td><a href="10-contributor-guide.html">Contributor guide</a>, <a href="06-cli-reference.html">CLI reference</a></td></tr><tr><td>User of the tool</td><td><a href="05-user-guide.html">User guide</a></td><td><a href="06-cli-reference.html">CLI reference</a>, <a href="11-glossary-and-faq.html">FAQ</a></td></tr><tr><td>Security reviewer or auditor</td><td><a href="13-trust-and-assurance.html">Trust and assurance</a></td><td><a href="14-real-world-evaluation.html">Real-world evaluation</a>, <a href="07-security-privacy-legal.html">Security, privacy and legal</a>, <a href="15-supply-chain-and-release.html">Supply chain</a>, <a href="../architecture/threat-model.html">Threat model</a></td></tr><tr><td>Lawyer</td><td><a href="../legal/legal-review-brief.html">Legal review brief</a></td><td><a href="../legal/trademark-and-name-clearance.html">Name clearance</a>, <a href="07-security-privacy-legal.html">Security, privacy and legal</a></td></tr></tbody></table></div>
@@ -43,14 +43,14 @@
43
43
  <div class="table-wrap" tabindex="0" role="region" aria-label="Table 2: Document list"><table><thead><tr><th scope="col">#</th><th scope="col">Document</th><th scope="col">Purpose</th></tr></thead><tbody><tr><td>01</td><td><a href="01-executive-summary.html">Executive summary</a></td><td>Problem, solution, value, risks, decisions needed</td></tr><tr><td>02</td><td><a href="02-functional-specification.html">Functional specification</a></td><td>What the system does, requirement by requirement</td></tr><tr><td>03</td><td><a href="03-technical-specification.html">Technical specification</a></td><td>How it is built: modules, data structures, algorithms, limits</td></tr><tr><td>04</td><td><a href="04-architecture.html">Architecture</a></td><td>C4 views, data flow, trust boundaries, decisions, quality attributes</td></tr><tr><td>05</td><td><a href="05-user-guide.html">User guide</a></td><td>Install, first audit, workflows, CI use, troubleshooting</td></tr><tr><td>06</td><td><a href="06-cli-reference.html">CLI reference</a></td><td>Every command, flag, exit code, output file and schema</td></tr><tr><td>07</td><td><a href="07-security-privacy-legal.html">Security, privacy and legal</a></td><td>Security model, privacy, licensing, trademarks, disclaimers</td></tr><tr><td>08</td><td><a href="08-testing-and-proof.html">Testing and proof</a></td><td>Test results, CI evidence, sample outputs, fixtures</td></tr><tr><td>09</td><td><a href="09-compatibility-and-roadmap.html">Compatibility and roadmap</a></td><td>Host matrix, verification status, milestones</td></tr><tr><td>10</td><td><a href="10-contributor-guide.html">Contributor guide</a></td><td>Add rules, agents, adapters; release process</td></tr><tr><td>11</td><td><a href="11-glossary-and-faq.html">Glossary and FAQ</a></td><td>Terms and the questions people ask most</td></tr><tr><td>12</td><td><a href="12-rule-catalog.html">Audit rule catalog</a></td><td>Every rule: what it detects, why, limits, fix</td></tr><tr><td>13</td><td><a href="13-trust-and-assurance.html">Trust and assurance</a></td><td>The register of every trust gap and its honest status</td></tr><tr><td>14</td><td><a href="14-real-world-evaluation.html">Real-world evaluation</a></td><td>Precision measured on 52 public repositories</td></tr><tr><td>15</td><td><a href="15-supply-chain-and-release.html">Supply chain and release</a></td><td>SBOM, provenance, pinning, release and verification steps</td></tr><tr><td>16</td><td><a href="16-performance-and-quality-metrics.html">Performance and quality metrics</a></td><td>Speed, memory, coverage, robustness</td></tr></tbody></table></div>
44
44
  <p>Also: <a href="../compatibility/smoke-tests/index.html">Live smoke tests</a>, <a href="../proof/accessibility.html">Accessibility audit</a>, <a href="../community/good-first-issues.html">Good first issues</a>, <a href="../legal/trademark-and-name-clearance.html">Name clearance</a>, <a href="../legal/legal-review-brief.html">Legal review brief</a>.</p>
45
45
  <h2 id="facts-at-a-glance">Facts at a glance<a class="anchor" href="#facts-at-a-glance" aria-label="Link to this section">#</a></h2>
46
- <div class="table-wrap" tabindex="0" role="region" aria-label="Table 3: Facts at a glance"><table><thead><tr><th scope="col">Item</th><th scope="col">Value</th></tr></thead><tbody><tr><td>Version</td><td>0.1.2</td></tr><tr><td>Creator</td><td>Vatsal Shah (<a href="https://github.com/shahvatsalofficial" rel="noopener">@shahvatsalofficial</a>)</td></tr><tr><td>License</td><td>Apache-2.0</td></tr><tr><td>Language / runtime</td><td>TypeScript (strict, ESM), Node.js 20+</td></tr><tr><td>Runtime dependencies</td><td>0</td></tr><tr><td>Skills / agents</td><td>5 skills, 12 agent roles</td></tr><tr><td>Audit rules</td><td>19</td></tr><tr><td>Automated tests</td><td>31</td></tr><tr><td>Test coverage</td><td>92% lines, 81% branches, 91% functions</td></tr><tr><td>CI</td><td>Ubuntu and Windows (Node 20, 22, 24), Ubuntu on newest Node; CodeQL; DCO check. macOS is not in CI</td></tr><tr><td>Real-world evaluation</td><td>52 repositories, 98 labeled findings; precision 50% (baseline), 69% and 95% (unseen batches)</td></tr><tr><td>Network use by the CLI</td><td>none</td></tr><tr><td>Model calls by the CLI</td><td>none</td></tr><tr><td>Repository</td><td><a href="https://github.com/shahvatsalofficial/archsutra-ai" rel="noopener">https://github.com/shahvatsalofficial/archsutra-ai</a></td></tr></tbody></table></div>
46
+ <div class="table-wrap" tabindex="0" role="region" aria-label="Table 3: Facts at a glance"><table><thead><tr><th scope="col">Item</th><th scope="col">Value</th></tr></thead><tbody><tr><td>Version</td><td>0.1.2</td></tr><tr><td>Creator</td><td><a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a></td></tr><tr><td>License</td><td>Apache-2.0</td></tr><tr><td>Language / runtime</td><td>TypeScript (strict, ESM), Node.js 20+</td></tr><tr><td>Runtime dependencies</td><td>0</td></tr><tr><td>Skills / agents</td><td>5 skills, 12 agent roles</td></tr><tr><td>Audit rules</td><td>19</td></tr><tr><td>Automated tests</td><td>31</td></tr><tr><td>Test coverage</td><td>92% lines, 81% branches, 91% functions</td></tr><tr><td>CI</td><td>Ubuntu and Windows (Node 20, 22, 24), Ubuntu on newest Node; CodeQL; DCO check. macOS is not in CI</td></tr><tr><td>Real-world evaluation</td><td>52 repositories, 98 labeled findings; precision 50% (baseline), 69% and 95% (unseen batches)</td></tr><tr><td>Network use by the CLI</td><td>none</td></tr><tr><td>Model calls by the CLI</td><td>none</td></tr><tr><td>Repository</td><td><a href="https://github.com/shahvatsalofficial/archsutra-ai" rel="noopener">https://github.com/shahvatsalofficial/archsutra-ai</a></td></tr></tbody></table></div>
47
47
  <h2 id="honesty-policy">Honesty policy<a class="anchor" href="#honesty-policy" aria-label="Link to this section">#</a></h2>
48
48
  <p>Every statement in this handbook is one of: <strong>implemented and tested</strong>, <strong>implemented but not yet verified in a live host</strong>, or <strong>planned</strong>. Where a claim is not verified it says so. If you find a statement that is not true, open an issue; that is a bug.</p></article></main>
49
49
  <aside class="rail"><nav class="toc" aria-label="On this page"><p class="nav-title">On this page</p><ul><li class="l2"><a href="#choose-your-path">Choose your path</a></li><li class="l2"><a href="#document-list">Document list</a></li><li class="l2"><a href="#facts-at-a-glance">Facts at a glance</a></li><li class="l2"><a href="#honesty-policy">Honesty policy</a></li></ul></nav></aside>
50
50
  </div>
51
51
  <footer class="footer">
52
52
  <div class="footer-inner">
53
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
53
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
54
54
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
55
55
  </div>
56
56
  </footer>
package/docs/index.html CHANGED
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"SoftwareSourceCode","name":"ArchSutra AI","description":"Open-source software architecture audit, design and threat-modeling agent skills and offline CLI for Claude Code, Cursor, Codex, GitHub Copilot and Gemini CLI.","codeRepository":"https://github.com/shahvatsalofficial/archsutra-ai","programmingLanguage":"TypeScript","runtimePlatform":"Node.js","license":"https://www.apache.org/licenses/LICENSE-2.0","version":"0.1.2","author":{"@type":"Person","name":"Vatsal Shah","url":"https://github.com/shahvatsalofficial"},"url":"https://shahvatsalofficial.github.io/archsutra-ai"}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"SoftwareSourceCode","name":"ArchSutra AI","description":"Open-source software architecture audit, design and threat-modeling agent skills and offline CLI for Claude Code, Cursor, Codex, GitHub Copilot and Gemini CLI.","codeRepository":"https://github.com/shahvatsalofficial/archsutra-ai","programmingLanguage":"TypeScript","runtimePlatform":"Node.js","license":"https://www.apache.org/licenses/LICENSE-2.0","version":"0.1.4","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"url":"https://shahvatsalofficial.github.io/archsutra-ai"}</script>
23
23
  <script type="application/ld+json">{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"What is ArchSutra AI?","acceptedAnswer":{"@type":"Answer","text":"An open-source software architecture agent: portable Agent Skills plus a deterministic offline CLI that help AI coding assistants audit, design, threat-model and modernize software with file-and-line evidence."}},{"@type":"Question","name":"Do I need an API key?","acceptedAnswer":{"@type":"Answer","text":"No. The CLI is offline. Inside a supported AI IDE the skills use that IDE's own model, so you need access to the IDE, not an ArchSutra key."}},{"@type":"Question","name":"Does it send my code anywhere?","acceptedAnswer":{"@type":"Answer","text":"The CLI sends nothing anywhere and has no telemetry. When you use the skills, your AI IDE's model provider processes your prompts and code under its own terms."}},{"@type":"Question","name":"Which AI tools does it support?","acceptedAnswer":{"@type":"Answer","text":"Adapters exist for Claude Code, Cursor, OpenAI Codex and GitHub Copilot (adapter level) and Gemini CLI (all adapter level: layouts match vendor docs read on 2026-11-01). Live smoke tests are pending and stated openly."}},{"@type":"Question","name":"Does it certify compliance or security?","acceptedAnswer":{"@type":"Answer","text":"No. Reports are review aids. Absence of findings is not proof of absence of vulnerabilities, and nothing here is legal advice or a compliance attestation."}}]}</script>
24
24
  </head>
25
25
  <body class="landing">
@@ -35,7 +35,7 @@
35
35
  <main id="main">
36
36
  <section class="hero">
37
37
  <div class="wrap">
38
- <p class="eyebrow">Open source &middot; Apache-2.0 &middot; v0.1.2</p>
38
+ <p class="eyebrow">Open source &middot; Apache-2.0 &middot; v0.1.4</p>
39
39
  <h1>The software architecture agent that shows its evidence.</h1>
40
40
  <p class="hero-lede">ArchSutra AI turns Claude Code, Cursor, Codex, GitHub Copilot and Gemini CLI into an evidence-first architect. Audit, design, threat-model and modernize with <code>file:line</code> proof, severity and confidence, no extra API key.</p>
41
41
  <div class="cta">
@@ -47,7 +47,7 @@
47
47
  <p class="hero-note">Read-only. Offline. No telemetry. Secrets redacted.</p>
48
48
  </div>
49
49
  </section>
50
- <section class="stats" aria-label="Facts"><div class="wrap"><ul><li><span class="num">30</span><span class="lbl">automated tests</span></li><li><span class="num">3 OS</span><span class="lbl">CI matrix, Node 20 and 22</span></li><li><span class="num">0</span><span class="lbl">runtime dependencies</span></li><li><span class="num">52</span><span class="lbl">real repositories evaluated</span></li><li><span class="num">98</span><span class="lbl">findings hand-labeled</span></li><li><span class="num">0</span><span class="lbl">API keys required</span></li></ul></div></section>
50
+ <section class="stats" aria-label="Facts"><div class="wrap"><ul><li><span class="num">36</span><span class="lbl">automated tests</span></li><li><span class="num">2 OS</span><span class="lbl">Ubuntu and Windows, Node 20, 22, 24</span></li><li><span class="num">0</span><span class="lbl">runtime dependencies</span></li><li><span class="num">52</span><span class="lbl">real repositories evaluated</span></li><li><span class="num">98</span><span class="lbl">findings hand-labeled</span></li><li><span class="num">0</span><span class="lbl">API keys required</span></li></ul></div></section>
51
51
  <section class="band"><div class="wrap">
52
52
  <h2>Why teams use it</h2>
53
53
  <div class="cards">
@@ -95,7 +95,7 @@
95
95
  </section></main>
96
96
  <footer class="footer">
97
97
  <div class="footer-inner">
98
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
98
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
99
99
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="handbook/07-security-privacy-legal.html">Legal details</a>.</p>
100
100
  </div>
101
101
  </footer>
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Legal review brief","description":"A ready-to-send package for a lawyer: what to review, the questions to answer, and the documents involved.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Legal review brief","description":"A ready-to-send package for a lawyer: what to review, the questions to answer, and the documents involved.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,7 +34,7 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html" aria-current="page">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Reference</p><h1 id="legal-review-brief">Legal review brief</h1>
37
- <p class="lede">A ready-to-send package for a lawyer: what to review, the questions to answer, and the documents involved.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/legal/legal-review-brief.md" rel="noopener">docs/legal/legal-review-brief.md</a></p>
37
+ <p class="lede">A ready-to-send package for a lawyer: what to review, the questions to answer, and the documents involved.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/legal/legal-review-brief.md" rel="noopener">docs/legal/legal-review-brief.md</a></p>
38
38
  <p>Purpose: give a qualified lawyer everything needed to review ArchSutra AI quickly. Nothing here has been reviewed by counsel yet.</p>
39
39
  <h2 id="project-in-one-paragraph">Project in one paragraph<a class="anchor" href="#project-in-one-paragraph" aria-label="Link to this section">#</a></h2>
40
40
  <p>ArchSutra AI is an open-source (Apache-2.0) tool: Agent Skill files plus a command-line program that statically analyzes source code locally and writes reports. It makes no network calls and sends no data. When users load the skill files into third-party AI coding assistants, those assistants process the user's code under their own terms. The project is currently free; any commercial offering (paid support, hosted service, consulting) is undecided.</p>
@@ -50,7 +50,7 @@
50
50
  </div>
51
51
  <footer class="footer">
52
52
  <div class="footer-inner">
53
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
53
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
54
54
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
55
55
  </div>
56
56
  </footer>
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Name and trademark clearance","description":"What was checked about the name \"ArchSutra\", what was not, the informal results, and the steps still needed before commercial use.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Name and trademark clearance","description":"What was checked about the name \"ArchSutra\", what was not, the informal results, and the steps still needed before commercial use.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,12 +34,12 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html" aria-current="page">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Reference</p><h1 id="name-and-trademark-clearance">Name and trademark clearance</h1>
37
- <p class="lede">What was checked about the name &quot;ArchSutra&quot;, what was not, the informal results, and the steps still needed before commercial use.</p><p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/legal/trademark-and-name-clearance.md" rel="noopener">docs/legal/trademark-and-name-clearance.md</a></p>
37
+ <p class="lede">What was checked about the name &quot;ArchSutra&quot;, what was not, the informal results, and the steps still needed before commercial use.</p><p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/legal/trademark-and-name-clearance.md" rel="noopener">docs/legal/trademark-and-name-clearance.md</a></p>
38
38
  <blockquote>This is a record of informal checks by the maintainers. It is <strong>not a trademark search, clearance opinion, or legal advice.</strong> Only a qualified trademark attorney, using professional search tools, can clear a name.</blockquote>
39
39
  <h2 id="status">Status<a class="anchor" href="#status" aria-label="Link to this section">#</a></h2>
40
- <div class="table-wrap" tabindex="0" role="region" aria-label="Table 1: Status"><table><thead><tr><th scope="col">Item</th><th scope="col">Status</th></tr></thead><tbody><tr><td>Formal trademark search (USPTO, EUIPO, WIPO Global Brand Database, IP India)</td><td><strong>Not done</strong></td></tr><tr><td>Attorney clearance opinion</td><td><strong>Not done</strong></td></tr><tr><td>Trademark application filed</td><td><strong>No</strong></td></tr><tr><td>Informal web and registry spot checks</td><td>Done on 2026-10-31 and 2026-11-01 (below)</td></tr><tr><td>Domain name</td><td>None registered for this project; the site is served from GitHub Pages</td></tr></tbody></table></div>
40
+ <div class="table-wrap" tabindex="0" role="region" aria-label="Table 1: Status"><table><thead><tr><th scope="col">Item</th><th scope="col">Status</th></tr></thead><tbody><tr><td>Formal trademark search (USPTO, EUIPO, WIPO Global Brand Database, IP India)</td><td><strong>Not done</strong></td></tr><tr><td>Attorney clearance opinion</td><td><strong>Not done</strong></td></tr><tr><td>Trademark application filed</td><td><strong>No</strong></td></tr><tr><td>Informal web and registry spot checks</td><td>Done on 2026-10-31, 2026-11-01, and 2026-11-06 (below)</td></tr><tr><td>Domain name</td><td>None registered for this project; the site is served from GitHub Pages</td></tr></tbody></table></div>
41
41
  <h2 id="informal-checks-performed">Informal checks performed<a class="anchor" href="#informal-checks-performed" aria-label="Link to this section">#</a></h2>
42
- <div class="table-wrap" tabindex="0" role="region" aria-label="Table 2: Informal checks performed"><table><thead><tr><th scope="col">Check</th><th scope="col">Date</th><th scope="col">Result</th></tr></thead><tbody><tr><td>npm registry: package <code>archsutra</code></td><td>2026-10-31</td><td>not found (name unclaimed)</td></tr><tr><td>npm registry: package <code>archsutra-ai</code></td><td>2026-10-31</td><td>not found (name unclaimed)</td></tr><tr><td>GitHub repository search for <code>archsutra</code></td><td>2026-10-31</td><td>only this project</td></tr><tr><td>Web search: &quot;ArchSutra&quot; with software, company, trademark</td><td>2026-11-01</td><td>no product, company or trademark record named ArchSutra surfaced; only look-alike names</td></tr><tr><td>Web search: &quot;Arch Sutra&quot; / &quot;ArchSutra AI&quot; architecture software</td><td>2026-11-01</td><td>no product by either name; the word &quot;Archisutra&quot; appears as a cultural term</td></tr></tbody></table></div>
42
+ <div class="table-wrap" tabindex="0" role="region" aria-label="Table 2: Informal checks performed"><table><thead><tr><th scope="col">Check</th><th scope="col">Date</th><th scope="col">Result</th></tr></thead><tbody><tr><td>npm registry: package <code>archsutra</code></td><td>2026-10-31</td><td>not found (name unclaimed)</td></tr><tr><td>npm registry: package <code>archsutra-ai</code></td><td>2026-10-31</td><td>not found (name unclaimed)</td></tr><tr><td>npm registry: package <code>archsutra</code></td><td>2026-11-06</td><td>still not found (name unclaimed)</td></tr><tr><td>npm registry: package <code>archsutra-ai</code></td><td>2026-11-06</td><td>published by this project (<code>0.1.2</code>, then <code>0.1.3</code>)</td></tr><tr><td>GitHub repository search for <code>archsutra</code></td><td>2026-10-31</td><td>only this project</td></tr><tr><td>Web search: &quot;ArchSutra&quot; with software, company, trademark</td><td>2026-11-01</td><td>no product, company or trademark record named ArchSutra surfaced; only look-alike names</td></tr><tr><td>Web search: &quot;Arch Sutra&quot; / &quot;ArchSutra AI&quot; architecture software</td><td>2026-11-01</td><td>no product by either name; the word &quot;Archisutra&quot; appears as a cultural term</td></tr></tbody></table></div>
43
43
  <p>Look-alike names seen in results (not conflicts by themselves, but show a crowded &quot;Arch&quot; naming space in architecture software): Arch Synth, ARCHITEChTURES, Archi Automate (Archi Systems AS), ArchtSoft, ArchiMate (a modeling language, unrelated).</p>
44
44
  <p><strong>Limits of these checks:</strong> general web search does not index trademark registers completely; unregistered (common-law) use is invisible to it; similarity analysis (sound, meaning, goods and services) was not performed.</p>
45
45
  <h2 id="what-clear-would-require">What &quot;clear&quot; would require<a class="anchor" href="#what-clear-would-require" aria-label="Link to this section">#</a></h2>
@@ -52,7 +52,7 @@
52
52
  </div>
53
53
  <footer class="footer">
54
54
  <div class="footer-inner">
55
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
55
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
56
56
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
57
57
  </div>
58
58
  </footer>
@@ -11,7 +11,7 @@
11
11
  | Formal trademark search (USPTO, EUIPO, WIPO Global Brand Database, IP India) | **Not done** |
12
12
  | Attorney clearance opinion | **Not done** |
13
13
  | Trademark application filed | **No** |
14
- | Informal web and registry spot checks | Done on 2026-10-31 and 2026-11-01 (below) |
14
+ | Informal web and registry spot checks | Done on 2026-10-31, 2026-11-01, and 2026-11-06 (below) |
15
15
  | Domain name | None registered for this project; the site is served from GitHub Pages |
16
16
 
17
17
  ## Informal checks performed
@@ -20,6 +20,8 @@
20
20
  |---|---|---|
21
21
  | npm registry: package `archsutra` | 2026-10-31 | not found (name unclaimed) |
22
22
  | npm registry: package `archsutra-ai` | 2026-10-31 | not found (name unclaimed) |
23
+ | npm registry: package `archsutra` | 2026-11-06 | still not found (name unclaimed) |
24
+ | npm registry: package `archsutra-ai` | 2026-11-06 | published by this project (`0.1.2`, then `0.1.3`) |
23
25
  | GitHub repository search for `archsutra` | 2026-10-31 | only this project |
24
26
  | Web search: "ArchSutra" with software, company, trademark | 2026-11-01 | no product, company or trademark record named ArchSutra surfaced; only look-alike names |
25
27
  | Web search: "Arch Sutra" / "ArchSutra AI" architecture software | 2026-11-01 | no product by either name; the word "Archisutra" appears as a cultural term |
@@ -19,7 +19,7 @@
19
19
  <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml">
20
20
  <link rel="stylesheet" href="../assets/site.css">
21
21
  <script>try{var t=localStorage.getItem('as-theme');if(t)document.documentElement.setAttribute('data-theme',t)}catch(e){}</script>
22
- <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Accessibility audit of the documentation site","description":"Accessibility audit of the documentation site - ArchSutra AI documentation.","author":{"@type":"Person","name":"Vatsal Shah"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
22
+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Accessibility audit of the documentation site","description":"Accessibility audit of the documentation site - ArchSutra AI documentation.","author":{"@type":"Person","name":"Vatsal Shah","url":"https://shahvatsal.com"},"inLanguage":"en","isPartOf":{"@type":"WebSite","name":"ArchSutra AI","url":"https://shahvatsalofficial.github.io/archsutra-ai"}}</script>
23
23
  </head>
24
24
  <body class="doc">
25
25
  <a class="skip" href="#main">Skip to content</a>
@@ -34,7 +34,7 @@
34
34
  <div class="layout">
35
35
  <aside id="sidebar" class="sidebar" aria-label="Documentation"><div class="nav-group"><p class="nav-title">Handbook</p><ul><li><a href="../handbook/index.html">Overview</a></li><li><a href="../handbook/01-executive-summary.html">Executive summary</a></li><li><a href="../handbook/02-functional-specification.html">Functional specification</a></li><li><a href="../handbook/03-technical-specification.html">Technical specification</a></li><li><a href="../handbook/04-architecture.html">Architecture</a></li><li><a href="../handbook/05-user-guide.html">User guide</a></li><li><a href="../handbook/06-cli-reference.html">CLI reference</a></li><li><a href="../handbook/07-security-privacy-legal.html">Security, privacy and legal</a></li><li><a href="../handbook/08-testing-and-proof.html">Testing and proof</a></li><li><a href="../handbook/09-compatibility-and-roadmap.html">Compatibility and roadmap</a></li><li><a href="../handbook/10-contributor-guide.html">Contributor guide</a></li><li><a href="../handbook/11-glossary-and-faq.html">Glossary and FAQ</a></li><li><a href="../handbook/12-rule-catalog.html">Audit rule catalog</a></li><li><a href="../handbook/13-trust-and-assurance.html">Trust and assurance</a></li><li><a href="../handbook/14-real-world-evaluation.html">Real-world evaluation</a></li><li><a href="../handbook/15-supply-chain-and-release.html">Supply chain and release</a></li><li><a href="../handbook/16-performance-and-quality-metrics.html">Performance and quality metrics</a></li></ul></div><div class="nav-group"><p class="nav-title">Reference</p><ul><li><a href="../architecture/overview.html">Architecture overview</a></li><li><a href="../architecture/threat-model.html">Threat model (ArchSutra CLI and skills)</a></li><li><a href="../compatibility/matrix.html">Compatibility matrix</a></li><li><a href="../rfc/0001-archsutra-v0.1.html">RFC 0001: ArchSutra AI v0.1</a></li><li><a href="../decisions/ADR-0001-deterministic-cli-plus-ide-skills.html">ADR-0001: Deterministic CLI plus IDE-native skills</a></li><li><a href="../compatibility/smoke-tests/index.html">Live smoke tests</a></li><li><a href="../community/good-first-issues.html">Good first issues (ready to file)</a></li><li><a href="../legal/trademark-and-name-clearance.html">Name and trademark clearance</a></li><li><a href="../legal/legal-review-brief.html">Legal review brief</a></li><li><a href="../proof/accessibility.html" aria-current="page">Accessibility audit of the documentation site</a></li></ul></div></aside>
36
36
  <main id="main" class="content"><article class="prose"><p class="crumbs"><a href="../index.html">ArchSutra AI</a> / Reference</p><h1 id="accessibility-audit-of-the-documentation-site">Accessibility audit of the documentation site</h1>
37
- <p class="meta">Version 0.1.2 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/proof/accessibility.md" rel="noopener">docs/proof/accessibility.md</a></p>
37
+ <p class="meta">Version 0.1.4 &middot; Source: <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/docs/proof/accessibility.md" rel="noopener">docs/proof/accessibility.md</a></p>
38
38
  <p>Method: axe-core 4.10.2 (tags wcag2a, wcag2aa, wcag21a, wcag21aa, wcag22aa, best-practice) run inside a real browser (the Claude desktop app's built-in Chromium-based browser pane) against every generated page, at 1280 px width, in both light and dark themes.</p>
39
39
  <p>Date: 2026-11-01. Pages: 19 (landing, 13 handbook pages, 5 reference pages). Runs: 38 (19 pages x 2 themes).</p>
40
40
  <h2 id="result">Result<a class="anchor" href="#result" aria-label="Link to this section">#</a></h2>
@@ -55,7 +55,7 @@
55
55
  </div>
56
56
  <footer class="footer">
57
57
  <div class="footer-inner">
58
- <p><strong>ArchSutra AI</strong> v0.1.2. Design. Audit. Evolve. Created by <a href="https://github.com/shahvatsalofficial" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
58
+ <p><strong>ArchSutra AI</strong> v0.1.4. Design. Audit. Evolve. Created by <a href="https://shahvatsal.com" rel="noopener">Vatsal Shah</a>. Licensed under <a href="https://github.com/shahvatsalofficial/archsutra-ai/blob/main/LICENSE" rel="noopener">Apache-2.0</a>.</p>
59
59
  <p class="fine">Review aid only. Not a certification, compliance attestation, security guarantee or legal advice. Not affiliated with Anthropic, OpenAI, Cursor, GitHub or Google; product names belong to their owners. <a href="../handbook/07-security-privacy-legal.html">Legal details</a>.</p>
60
60
  </div>
61
61
  </footer>