From c9cbb4f4b9f1fb6ec93d066193ec6c3a24b3bc3a Mon Sep 17 00:00:00 2001 From: James Sesler Date: Thu, 23 Jul 2026 01:48:47 -0400 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20update=20website=20to=20v0.12.9=20?= =?UTF-8?q?=E2=80=94=2018=20MCP=20tools,=20new=20Pi=20commands,=20vision?= =?UTF-8?q?=20interview?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs.html | 49 ++++++++++++++++++++++++++++++++++++++++--------- features.html | 2 +- index.html | 8 ++++---- showcase.html | 2 +- 4 files changed, 46 insertions(+), 15 deletions(-) diff --git a/docs.html b/docs.html index 2004c9e..c91b2f4 100644 --- a/docs.html +++ b/docs.html @@ -59,7 +59,7 @@

Copy one folder into any repository.

Step 2: Pick a pipeline (optional)
-

Edit .codecarto/workflow/status.yaml and set the pipeline field. Defaults to the 7-phase full analysis with a split defect scan.

+

Edit .codecarto/workflow/status.yaml and set the pipeline field. Defaults to the 7-phase full analysis with a split defect scan. Pi and MCP users can run /codecarto-switch-pipeline instead of hand-editing.

# Available pipeline paths:
 pipeline: workflow/pipeline-full-with-deep-audit.yaml  # 7-phase (default)
 pipeline: workflow/pipeline-full-with-audit.yaml       # 6-phase
@@ -138,6 +138,34 @@ 
Slash commands, widgets, and tool gating.

           
/codecarto-usage

           
Show cumulative and per-phase token usage from local phase runs.
+
+

/codecarto-open

+

Activate an existing workspace without resetting state.

+
+
+

/codecarto-vision

+

Run a guided product discovery interview for the synthesis pipeline.

+
+
+

/codecarto-switch-pipeline

+

Switch the active pipeline without losing findings or progress.

+
+
+

/codecarto-publish

+

Publish the reimplementation spec to a configured library.

+
+
+

/codecarto-library-init

+

Initialize a library directory with marker and config.

+
+
+

/codecarto-config

+

Show the effective merged configuration.

+
+
+

/codecarto-dashboard

+

Regenerate the dashboard HTML.

+
@@ -147,7 +175,7 @@

Slash commands, widgets, and tool gating.

03 · MCP server
-

10 tools for any MCP-compatible host.

+

18 tools for any MCP-compatible host.

The same core primitives exposed as a Model Context Protocol server. Wire it into Claude Code, Claude Desktop, or any MCP host. The host runs the LLM, isolates phase sessions, and controls @@ -182,11 +210,14 @@

10 tools for any MCP-compatible host.

- The server exposes 10 workflow and library tools: codecarto_init, - codecarto_status, codecarto_next, codecarto_phase, - codecarto_validate, codecarto_complete, and - codecarto_skill, plus codecarto_publish, - codecarto_library_list, and codecarto_library_reindex. + The server exposes 18 workflow and library tools: codecarto_init, + codecarto_status, codecarto_switch_pipeline, codecarto_next, + codecarto_phase, codecarto_validate, codecarto_complete, + codecarto_skill, codecarto_publish, codecarto_library_list, + codecarto_library_reindex, codecarto_library_init, + codecarto_config, codecarto_vision, codecarto_open, + codecarto_usage, codecarto_dashboard, and + codecarto_list_skills. Workflow tools accept an absolute cwd for the target repository; library tools accept a configured or explicit library path.

@@ -208,7 +239,7 @@

Turn confirmed software maps into a traceable build plan.

Start
/codecarto-init synthesis
-# Fill .codecarto/inputs/vision.md
+# Fill .codecarto/inputs/vision.md, or run /codecarto-vision for a guided interview
 /codecarto-next --auto

The first run creates a ranked proposal, completes that phase, and then intentionally stops at the confirmation preflight.

@@ -333,7 +364,7 @@

Package

- v0.12.0 · MIT License + v0.12.9 · MIT License codecarto.dev
diff --git a/features.html b/features.html index fce3315..f7aa610 100644 --- a/features.html +++ b/features.html @@ -369,7 +369,7 @@

Package

- v0.12.0 · MIT License + v0.12.9 · MIT License codecarto.dev
diff --git a/index.html b/index.html index 45f07f4..822b42e 100644 --- a/index.html +++ b/index.html @@ -41,7 +41,7 @@
- Evidence-backed software cartography · v0.12.0 + Evidence-backed software cartography · v0.12.9

Understand existing software. Plan what comes next.

@@ -240,11 +240,11 @@

Works anywhere an LLM can read and write files.

Pi extension

-

Install the package and use /codecarto-init, /codecarto-next, /codecarto-status, and more. Phase sub-agents run in parallel widgets with live token tracking.

+

Install the package and use /codecarto-init, /codecarto-next, /codecarto-status, /codecarto-vision, /codecarto-switch-pipeline, and more. Phase sub-agents run in parallel widgets with live token tracking.

MCP server

-

10 tools for workflow control and library operations. Wire them into Claude Code, Claude Desktop, or any MCP-compatible host. The host owns phase sessions and compaction; CodeCartographer supplies byte-identical prompts and validation.

+

18 tools for workflow control and library operations. Wire them into Claude Code, Claude Desktop, or any MCP-compatible host. The host owns phase sessions and compaction; CodeCartographer supplies byte-identical prompts and validation.

Drop-in template

@@ -306,7 +306,7 @@

Package

- v0.12.0 · MIT License + v0.12.9 · MIT License codecarto.dev
diff --git a/showcase.html b/showcase.html index 691f847..8a7075e 100644 --- a/showcase.html +++ b/showcase.html @@ -265,7 +265,7 @@

Package

- v0.12.0 · MIT License + v0.12.9 · MIT License codecarto.dev
From c063ce386fcfc3b956e497c28d8896480b6af8a9 Mon Sep 17 00:00:00 2001 From: James Sesler Date: Thu, 23 Jul 2026 17:32:31 -0400 Subject: [PATCH 2/2] docs: update website to v0.12.10 --- README.md | 29 +++++++++++++---------------- docs.html | 36 +++++++++++++++++------------------- features.html | 2 +- index.html | 6 +++--- showcase.html | 2 +- 5 files changed, 35 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index c8e3391..9e65bf5 100644 --- a/README.md +++ b/README.md @@ -6,29 +6,26 @@ Static marketing site for `codecarto.dev`. Built on the Hearth UI design templat - `index.html` — overview and landing page - `features.html` — pipeline variants, evidence classification, phase-gating, output artifacts -- `docs.html` — installation (drop-in, Pi-mono, MCP), configuration, cPanel deployment +- `docs.html` — installation (drop-in, Pi-mono, MCP), configuration, GitHub Pages deployment - `showcase.html` — example outputs, defect scan passes, model compatibility, use cases - `site.css` — marketing site styles (imports `colors_and_type.css`) - `colors_and_type.css` — canonical design tokens (palette, typography, spacing, shadows) - `logo.svg` — CodeCartographer map/matrix brand icon and favicon - `script.js` — pipeline switcher, copy buttons, scroll reveals -- `.htaccess` — Apache config (HTTPS redirect, security headers) +- `CNAME` — GitHub Pages custom-domain configuration for `codecarto.dev` - `robots.txt` — crawler guidance - `sitemap.xml` — sitemap for the live domain -- `LAUNCH_CHECKLIST.md` — cPanel launch and post-upload verification checklist - -## Deploy To Namecheap cPanel - -1. Open Namecheap cPanel for the account serving `codecarto.dev`. -2. Go to File Manager. -3. Open the document root for the domain: - - primary domain: usually `public_html/` - - addon domain: the folder assigned as that domain's document root -4. Upload the contents of this folder into that document root. -5. Confirm `index.html` is at the top of the document root. -6. Enable AutoSSL for `codecarto.dev`. -7. Force HTTPS in the domain settings or with the `.htaccess` file. -8. Visit `https://codecarto.dev/` and hard refresh. + +## Deploy With GitHub Pages + +GitHub Pages publishes the repository's `main` branch from the repository root. + +1. Open a pull request targeting `main`. +2. Run `npm test` against the authoritative CodeCartographer checkout and wait for the pull-request checks to pass. +3. Merge the pull request. GitHub Pages automatically starts a new deployment. +4. Confirm the latest Pages build completed successfully in the repository's **Settings → Pages** view. +5. Keep `CNAME` set to `codecarto.dev`; GitHub Pages manages the approved TLS certificate and enforces HTTPS. +6. Visit `https://codecarto.dev/` and hard refresh. ## Important Link Notes diff --git a/docs.html b/docs.html index c91b2f4..de52889 100644 --- a/docs.html +++ b/docs.html @@ -4,7 +4,7 @@ Docs — CodeCartographer - + @@ -59,7 +59,7 @@

Copy one folder into any repository.

Step 2: Pick a pipeline (optional)
-

Edit .codecarto/workflow/status.yaml and set the pipeline field. Defaults to the 7-phase full analysis with a split defect scan. Pi and MCP users can run /codecarto-switch-pipeline instead of hand-editing.

+

Edit .codecarto/workflow/status.yaml and set the pipeline field. Defaults to the 7-phase full analysis with a split defect scan.

# Available pipeline paths:
 pipeline: workflow/pipeline-full-with-deep-audit.yaml  # 7-phase (default)
 pipeline: workflow/pipeline-full-with-audit.yaml       # 6-phase
@@ -216,8 +216,7 @@ 
18 tools for any MCP-compatible host.

       codecarto_skill, codecarto_publish, codecarto_library_list,
       codecarto_library_reindex, codecarto_library_init,
       codecarto_config, codecarto_vision, codecarto_open,
-      codecarto_usage, codecarto_dashboard, and
-      codecarto_list_skills.
+      codecarto_usage, codecarto_dashboard, and codecarto_list_skills.
       Workflow tools accept an absolute cwd for the target repository; library tools
       accept a configured or explicit library path.
     

@@ -239,7 +238,7 @@ 
Turn confirmed software maps into a traceable build plan.

       

         
Start

         
/codecarto-init synthesis
-# Fill .codecarto/inputs/vision.md, or run /codecarto-vision for a guided interview
+# Fill .codecarto/inputs/vision.md
 /codecarto-next --auto

         
The first run creates a ranked proposal, completes that phase, and then intentionally stops at the confirmation preflight.

       

@@ -259,30 +258,29 @@ 
Turn confirmed software maps into a traceable build plan.
- +
-
05 · Deploy to Namecheap cPanel
-

Upload the static bundle and point the domain at it.

+
05 · Deploy with GitHub Pages
+

Merge to main and let GitHub Pages publish the site.

- This site is plain HTML, CSS, and JavaScript. Drop it into public_html on your - cPanel host and it is live. + This site is plain HTML, CSS, and JavaScript. GitHub Pages serves the repository's + main branch from the repository root at codecarto.dev.

    -
  1. Open Namecheap cPanel and navigate to File Manager.
    2. -
  2. Open the document root for codecarto.dev. For a primary domain this is public_html/. For an addon domain it is the folder assigned as that domain's document root.
    3. -
  3. Upload the entire contents of this website/ folder into that document root.
    4. -
  4. Confirm index.html sits at the top of the document root.
    5. -
  5. Enable AutoSSL for the domain in cPanel.
    6. -
  6. Force HTTPS with the included .htaccess file or the cPanel domain settings.
    7. +
  7. Open a pull request targeting main.
    8. +
  8. Run npm test against the authoritative CodeCartographer checkout and wait for the pull-request checks to pass.
    9. +
  9. Merge the pull request. GitHub Pages automatically starts a deployment from main at /(root).
    10. +
  10. Confirm the latest build completed in Settings → Pages.
    11. +
  11. Keep CNAME set to codecarto.dev. GitHub Pages manages the approved TLS certificate and enforces HTTPS.
  12. Visit https://codecarto.dev/ and hard refresh.
-
Files to upload
+
Published site files
  • index.html
  • features.html
    • @@ -291,7 +289,7 @@

    Upload the static bundle and point the domain at it.

  • site.css
  • colors_and_type.css
  • script.js
    • -
  • .htaccess
    • +
  • CNAME
  • robots.txt
  • sitemap.xml
@@ -364,7 +362,7 @@

Package

- v0.12.9 · MIT License + v0.12.10 · MIT License codecarto.dev
diff --git a/features.html b/features.html index f7aa610..d80bf4c 100644 --- a/features.html +++ b/features.html @@ -369,7 +369,7 @@

Package

- v0.12.9 · MIT License + v0.12.10 · MIT License codecarto.dev
diff --git a/index.html b/index.html index 822b42e..878670c 100644 --- a/index.html +++ b/index.html @@ -41,7 +41,7 @@
- Evidence-backed software cartography · v0.12.9 + Evidence-backed software cartography · v0.12.10

Understand existing software. Plan what comes next.

@@ -240,7 +240,7 @@

Works anywhere an LLM can read and write files.

Pi extension

-

Install the package and use /codecarto-init, /codecarto-next, /codecarto-status, /codecarto-vision, /codecarto-switch-pipeline, and more. Phase sub-agents run in parallel widgets with live token tracking.

+

Install the package and use /codecarto-init, /codecarto-next, /codecarto-status, and more. Phase sub-agents run in parallel widgets with live token tracking.

MCP server

@@ -306,7 +306,7 @@

Package

- v0.12.9 · MIT License + v0.12.10 · MIT License codecarto.dev
diff --git a/showcase.html b/showcase.html index 8a7075e..174cb05 100644 --- a/showcase.html +++ b/showcase.html @@ -265,7 +265,7 @@

Package

- v0.12.9 · MIT License + v0.12.10 · MIT License codecarto.dev