diff --git a/404.html b/404.html index 04e36db..aa1b2f4 100644 --- a/404.html +++ b/404.html @@ -4,7 +4,7 @@ Development Hub - + diff --git a/assets/js/1db64337.18f4a9e2.js b/assets/js/1db64337.18f4a9e2.js deleted file mode 100644 index 3899174..0000000 --- a/assets/js/1db64337.18f4a9e2.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(globalThis.webpackChunkproject_public_docs=globalThis.webpackChunkproject_public_docs||[]).push([[413],{6785(e,t,n){n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>c,default:()=>h,frontMatter:()=>o,metadata:()=>r,toc:()=>d});const r=JSON.parse('{"id":"overview","title":"Development Hub","description":"Central orchestration project for managing Rob\'s multi-project development ecosystem.","source":"@site/docs/overview.md","sourceDirName":".","slug":"/","permalink":"/rob/development-hub/","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":1,"frontMatter":{"slug":"/","sidebar_position":1},"sidebar":"docs"}');var i=n(4848),s=n(8453);const o={slug:"/",sidebar_position:1},c="Development Hub",l={},d=[{value:"Overview",id:"overview",level:2},{value:"The new-project Script",id:"the-new-project-script",level:2},{value:"What It Creates",id:"what-it-creates",level:3},{value:"Usage",id:"usage",level:3},{value:"Project Structure",id:"project-structure",level:2},{value:"Configuration",id:"configuration",level:2},{value:"Gitea API Token",id:"gitea-api-token",level:3},{value:"Related Projects",id:"related-projects",level:2}];function a(e){const t={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(t.header,{children:(0,i.jsx)(t.h1,{id:"development-hub",children:"Development Hub"})}),"\n",(0,i.jsx)(t.p,{children:"Central orchestration project for managing Rob's multi-project development ecosystem."}),"\n",(0,i.jsx)(t.h2,{id:"overview",children:"Overview"}),"\n",(0,i.jsx)(t.p,{children:"Development Hub provides tooling to create and manage projects that follow consistent patterns:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsx)(t.li,{children:"Centralized documentation via Docusaurus"}),"\n",(0,i.jsx)(t.li,{children:"Gitea repository hosting with Pages support"}),"\n",(0,i.jsx)(t.li,{children:"AI-assistant context files (CLAUDE.md)"}),"\n",(0,i.jsx)(t.li,{children:"Python project structure"}),"\n"]}),"\n",(0,i.jsxs)(t.h2,{id:"the-new-project-script",children:["The ",(0,i.jsx)(t.code,{children:"new-project"})," Script"]}),"\n",(0,i.jsxs)(t.p,{children:["The main tool is ",(0,i.jsx)(t.code,{children:"new-project"}),", which automates creating a new project in the ecosystem:"]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-bash",children:'new-project my-tool --title "My Tool" --tagline "Does useful things"\n'})}),"\n",(0,i.jsx)(t.h3,{id:"what-it-creates",children:"What It Creates"}),"\n",(0,i.jsxs)(t.ol,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Gitea repository"})," at ",(0,i.jsx)(t.code,{children:"gitea.brrd.tech/rob/my-tool"})]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Local project"})," at ",(0,i.jsx)(t.code,{children:"~/PycharmProjects/my-tool/"})," with:","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"CLAUDE.md"})," - AI assistant context"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"README.md"})," - Project readme"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"pyproject.toml"})," - Python packaging"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:".gitignore"})," - Standard ignores"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"docs/"})," - Symlink to centralized docs"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Documentation folder"})," at ",(0,i.jsx)(t.code,{children:"project-docs/docs/projects/my-tool/"})]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.strong,{children:"Build configuration"})," in ",(0,i.jsx)(t.code,{children:"build-public-docs.sh"})]}),"\n"]}),"\n",(0,i.jsx)(t.h3,{id:"usage",children:"Usage"}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-bash",children:'# Full specification\nnew-project myproject --title "My Project" --tagline "Short description"\n\n# Interactive mode (prompts for title/tagline)\nnew-project myproject\n\n# Options\n--dry-run Show what would happen without making changes\n--skip-gitea Skip Gitea repo creation (for offline use)\n--help Show help\n'})}),"\n",(0,i.jsx)(t.h2,{id:"project-structure",children:"Project Structure"}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{children:"development-hub/\n\u251c\u2500\u2500 bin/\n\u2502 \u2514\u2500\u2500 new-project # Main scaffolding script\n\u251c\u2500\u2500 templates/\n\u2502 \u251c\u2500\u2500 gitignore.template\n\u2502 \u251c\u2500\u2500 CLAUDE.md.template\n\u2502 \u251c\u2500\u2500 README.md.template\n\u2502 \u251c\u2500\u2500 pyproject.toml.template\n\u2502 \u251c\u2500\u2500 overview.md.template\n\u2502 \u2514\u2500\u2500 updating-documentation.md.template\n\u251c\u2500\u2500 docs/ # Symlink to this folder\n\u251c\u2500\u2500 CLAUDE.md\n\u251c\u2500\u2500 README.md\n\u2514\u2500\u2500 .gitignore\n"})}),"\n",(0,i.jsx)(t.h2,{id:"configuration",children:"Configuration"}),"\n",(0,i.jsx)(t.h3,{id:"gitea-api-token",children:"Gitea API Token"}),"\n",(0,i.jsx)(t.p,{children:"The script needs a Gitea API token to create repositories automatically."}),"\n",(0,i.jsx)(t.p,{children:(0,i.jsx)(t.strong,{children:"Setup options:"})}),"\n",(0,i.jsxs)(t.ol,{children:["\n",(0,i.jsxs)(t.li,{children:["Environment variable: ",(0,i.jsx)(t.code,{children:"export GITEA_TOKEN=your_token"})]}),"\n",(0,i.jsxs)(t.li,{children:["Config file: ",(0,i.jsx)(t.code,{children:"~/.config/development-hub/gitea-token"})]}),"\n"]}),"\n",(0,i.jsx)(t.p,{children:"The script will prompt for the token on first run and save it automatically."}),"\n",(0,i.jsx)(t.p,{children:(0,i.jsx)(t.strong,{children:"Creating a token:"})}),"\n",(0,i.jsxs)(t.ol,{children:["\n",(0,i.jsxs)(t.li,{children:["Go to ",(0,i.jsx)(t.a,{href:"https://gitea.brrd.tech/user/settings/applications",children:"https://gitea.brrd.tech/user/settings/applications"})]}),"\n",(0,i.jsx)(t.li,{children:"Generate a new token with 'repo' scope"}),"\n",(0,i.jsx)(t.li,{children:"Copy the token when prompted"}),"\n"]}),"\n",(0,i.jsx)(t.h2,{id:"related-projects",children:"Related Projects"}),"\n",(0,i.jsx)(t.p,{children:"Development Hub manages these projects:"}),"\n",(0,i.jsxs)(t.table,{children:[(0,i.jsx)(t.thead,{children:(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.th,{children:"Project"}),(0,i.jsx)(t.th,{children:"Description"})]})}),(0,i.jsxs)(t.tbody,{children:[(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.a,{href:"../cmdforge/overview",children:"CmdForge"})}),(0,i.jsx)(t.td,{children:"AI-powered CLI tool builder"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.a,{href:"../cascadingdev/overview",children:"CascadingDev"})}),(0,i.jsx)(t.td,{children:"Cascading Development Framework"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.a,{href:"../orchestrated-discussions/overview",children:"Orchestrated Discussions"})}),(0,i.jsx)(t.td,{children:"AI Discussion Framework"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.a,{href:"../artifact-editor/overview",children:"Artifact Editor"})}),(0,i.jsx)(t.td,{children:"Code Artifact Editor"})]}),(0,i.jsxs)(t.tr,{children:[(0,i.jsx)(t.td,{children:(0,i.jsx)(t.a,{href:"../ramble/overview",children:"Ramble"})}),(0,i.jsx)(t.td,{children:"Voice Note Transcription"})]})]})]}),"\n",(0,i.jsxs)(t.p,{children:["All projects follow the same patterns and can be created using ",(0,i.jsx)(t.code,{children:"new-project"}),"."]})]})}function h(e={}){const{wrapper:t}={...(0,s.R)(),...e.components};return t?(0,i.jsx)(t,{...e,children:(0,i.jsx)(a,{...e})}):a(e)}},8453(e,t,n){n.d(t,{R:()=>o,x:()=>c});var r=n(6540);const i={},s=r.createContext(i);function o(e){const t=r.useContext(s);return r.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function c(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),r.createElement(s.Provider,{value:t},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/1db64337.e2b8ddcf.js b/assets/js/1db64337.e2b8ddcf.js new file mode 100644 index 0000000..8f37450 --- /dev/null +++ b/assets/js/1db64337.e2b8ddcf.js @@ -0,0 +1 @@ +"use strict";(globalThis.webpackChunkproject_public_docs=globalThis.webpackChunkproject_public_docs||[]).push([[413],{6785(e,n,t){t.r(n),t.d(n,{assets:()=>c,contentTitle:()=>o,default:()=>h,frontMatter:()=>l,metadata:()=>r,toc:()=>d});const r=JSON.parse('{"id":"overview","title":"Development Hub","description":"Central orchestration project for managing Rob\'s multi-project development ecosystem.","source":"@site/docs/overview.md","sourceDirName":".","slug":"/","permalink":"/rob/development-hub/","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":1,"frontMatter":{"slug":"/","sidebar_position":1},"sidebar":"docs"}');var i=t(4848),s=t(8453);const l={slug:"/",sidebar_position:1},o="Development Hub",c={},d=[{value:"Overview",id:"overview",level:2},{value:"GUI Application",id:"gui-application",level:2},{value:"Running the App",id:"running-the-app",level:3},{value:"Features",id:"features",level:3},{value:"Keyboard Shortcuts",id:"keyboard-shortcuts",level:3},{value:"The new-project Script",id:"the-new-project-script",level:2},{value:"What It Creates",id:"what-it-creates",level:3},{value:"Usage",id:"usage",level:3},{value:"Project Structure",id:"project-structure",level:2},{value:"Configuration",id:"configuration",level:2},{value:"Gitea API Token",id:"gitea-api-token",level:3},{value:"Related Projects",id:"related-projects",level:2}];function a(e){const n={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.header,{children:(0,i.jsx)(n.h1,{id:"development-hub",children:"Development Hub"})}),"\n",(0,i.jsx)(n.p,{children:"Central orchestration project for managing Rob's multi-project development ecosystem."}),"\n",(0,i.jsx)(n.h2,{id:"overview",children:"Overview"}),"\n",(0,i.jsx)(n.p,{children:"Development Hub provides:"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"GUI Application"})," - PyQt6 workspace with project list, splittable terminal panes, and session persistence"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"CLI Tools"})," - Scripts to create and manage projects following consistent patterns"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Centralized Documentation"})," - Docusaurus-based docs with Gitea Pages deployment"]}),"\n"]}),"\n",(0,i.jsx)(n.h2,{id:"gui-application",children:"GUI Application"}),"\n",(0,i.jsx)(n.p,{children:"A PyQt6-based workspace for managing your development projects."}),"\n",(0,i.jsx)(n.h3,{id:"running-the-app",children:"Running the App"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-bash",children:"cd ~/PycharmProjects/development-hub\nsource .venv/bin/activate\npython -m development_hub\n"})}),"\n",(0,i.jsx)(n.h3,{id:"features",children:"Features"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Project List"})," - Auto-discovers projects, right-click for actions (terminal, editor, Gitea, docs, deploy)"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Splittable Panes"})," - Horizontal/vertical splits, each pane has its own tab bar"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"PTY Terminals"})," - Full terminal emulation with TUI support (vim, htop work)"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Drag & Drop"})," - Drop files/folders into terminal to inject paths"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Session Persistence"})," - Remembers pane layout and open terminals on restart"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"New Project Dialog"})," - Create projects with optional Ramble voice input"]}),"\n"]}),"\n",(0,i.jsx)(n.h3,{id:"keyboard-shortcuts",children:"Keyboard Shortcuts"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.th,{children:"Shortcut"}),(0,i.jsx)(n.th,{children:"Action"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+Shift+T"})}),(0,i.jsx)(n.td,{children:"New terminal tab"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+Shift+W"})}),(0,i.jsx)(n.td,{children:"Close current tab"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+Shift+D"})}),(0,i.jsx)(n.td,{children:"Split horizontal"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+Shift+E"})}),(0,i.jsx)(n.td,{children:"Split vertical"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+Alt+Left/Right"})}),(0,i.jsx)(n.td,{children:"Switch panes"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+B"})}),(0,i.jsx)(n.td,{children:"Toggle project panel"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.code,{children:"Ctrl+N"})}),(0,i.jsx)(n.td,{children:"New project dialog"})]})]})]}),"\n",(0,i.jsxs)(n.h2,{id:"the-new-project-script",children:["The ",(0,i.jsx)(n.code,{children:"new-project"})," Script"]}),"\n",(0,i.jsxs)(n.p,{children:["The main tool is ",(0,i.jsx)(n.code,{children:"new-project"}),", which automates creating a new project in the ecosystem:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-bash",children:'new-project my-tool --title "My Tool" --tagline "Does useful things"\n'})}),"\n",(0,i.jsx)(n.h3,{id:"what-it-creates",children:"What It Creates"}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Gitea repository"})," at ",(0,i.jsx)(n.code,{children:"gitea.brrd.tech/rob/my-tool"})]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Local project"})," at ",(0,i.jsx)(n.code,{children:"~/PycharmProjects/my-tool/"})," with:","\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.code,{children:"CLAUDE.md"})," - AI assistant context"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.code,{children:"README.md"})," - Project readme"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.code,{children:"pyproject.toml"})," - Python packaging"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.code,{children:".gitignore"})," - Standard ignores"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.code,{children:"docs/"})," - Symlink to centralized docs"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Documentation folder"})," at ",(0,i.jsx)(n.code,{children:"project-docs/docs/projects/my-tool/"})]}),"\n",(0,i.jsxs)(n.li,{children:[(0,i.jsx)(n.strong,{children:"Build configuration"})," in ",(0,i.jsx)(n.code,{children:"build-public-docs.sh"})]}),"\n"]}),"\n",(0,i.jsx)(n.h3,{id:"usage",children:"Usage"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-bash",children:'# Full specification\nnew-project myproject --title "My Project" --tagline "Short description"\n\n# Interactive mode (prompts for title/tagline)\nnew-project myproject\n\n# Options\n--dry-run Show what would happen without making changes\n--skip-gitea Skip Gitea repo creation (for offline use)\n--help Show help\n'})}),"\n",(0,i.jsx)(n.h2,{id:"project-structure",children:"Project Structure"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{children:"development-hub/\n\u251c\u2500\u2500 src/development_hub/ # GUI application\n\u2502 \u251c\u2500\u2500 main_window.py # Main window with menus\n\u2502 \u251c\u2500\u2500 project_list.py # Project discovery & context menu\n\u2502 \u251c\u2500\u2500 workspace.py # Splittable pane layout\n\u2502 \u251c\u2500\u2500 terminal_widget.py # PTY terminal with pyte\n\u2502 \u251c\u2500\u2500 dialogs.py # New Project, Settings dialogs\n\u2502 \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 bin/\n\u2502 \u2514\u2500\u2500 new-project # CLI scaffolding script\n\u251c\u2500\u2500 templates/ # Project templates\n\u251c\u2500\u2500 docs/ # Symlink to this folder\n\u251c\u2500\u2500 pyproject.toml\n\u251c\u2500\u2500 CLAUDE.md\n\u2514\u2500\u2500 README.md\n"})}),"\n",(0,i.jsx)(n.h2,{id:"configuration",children:"Configuration"}),"\n",(0,i.jsx)(n.h3,{id:"gitea-api-token",children:"Gitea API Token"}),"\n",(0,i.jsx)(n.p,{children:"The script needs a Gitea API token to create repositories automatically."}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.strong,{children:"Setup options:"})}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsxs)(n.li,{children:["Environment variable: ",(0,i.jsx)(n.code,{children:"export GITEA_TOKEN=your_token"})]}),"\n",(0,i.jsxs)(n.li,{children:["Config file: ",(0,i.jsx)(n.code,{children:"~/.config/development-hub/gitea-token"})]}),"\n"]}),"\n",(0,i.jsx)(n.p,{children:"The script will prompt for the token on first run and save it automatically."}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.strong,{children:"Creating a token:"})}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsxs)(n.li,{children:["Go to ",(0,i.jsx)(n.a,{href:"https://gitea.brrd.tech/user/settings/applications",children:"https://gitea.brrd.tech/user/settings/applications"})]}),"\n",(0,i.jsx)(n.li,{children:"Generate a new token with 'repo' scope"}),"\n",(0,i.jsx)(n.li,{children:"Copy the token when prompted"}),"\n"]}),"\n",(0,i.jsx)(n.h2,{id:"related-projects",children:"Related Projects"}),"\n",(0,i.jsx)(n.p,{children:"Development Hub manages these projects:"}),"\n",(0,i.jsxs)(n.table,{children:[(0,i.jsx)(n.thead,{children:(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.th,{children:"Project"}),(0,i.jsx)(n.th,{children:"Description"})]})}),(0,i.jsxs)(n.tbody,{children:[(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.a,{href:"../cmdforge/overview",children:"CmdForge"})}),(0,i.jsx)(n.td,{children:"AI-powered CLI tool builder"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.a,{href:"../cascadingdev/overview",children:"CascadingDev"})}),(0,i.jsx)(n.td,{children:"Cascading Development Framework"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.a,{href:"../orchestrated-discussions/overview",children:"Orchestrated Discussions"})}),(0,i.jsx)(n.td,{children:"AI Discussion Framework"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.a,{href:"../artifact-editor/overview",children:"Artifact Editor"})}),(0,i.jsx)(n.td,{children:"Code Artifact Editor"})]}),(0,i.jsxs)(n.tr,{children:[(0,i.jsx)(n.td,{children:(0,i.jsx)(n.a,{href:"../ramble/overview",children:"Ramble"})}),(0,i.jsx)(n.td,{children:"Voice Note Transcription"})]})]})]}),"\n",(0,i.jsxs)(n.p,{children:["All projects follow the same patterns and can be created using ",(0,i.jsx)(n.code,{children:"new-project"}),"."]})]})}function h(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(a,{...e})}):a(e)}},8453(e,n,t){t.d(n,{R:()=>l,x:()=>o});var r=t(6540);const i={},s=r.createContext(i);function l(e){const n=r.useContext(s);return r.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function o(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:l(e.components),r.createElement(s.Provider,{value:n},e.children)}}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.0e3f1510.js b/assets/js/runtime~main.20c2acbd.js similarity index 96% rename from assets/js/runtime~main.0e3f1510.js rename to assets/js/runtime~main.20c2acbd.js index 8d1bdc5..8995d79 100644 --- a/assets/js/runtime~main.0e3f1510.js +++ b/assets/js/runtime~main.20c2acbd.js @@ -1 +1 @@ -(()=>{"use strict";var e,r,t,a,o,n={},i={};function l(e){var r=i[e];if(void 0!==r)return r.exports;var t=i[e]={id:e,loaded:!1,exports:{}};return n[e].call(t.exports,t,t.exports,l),t.loaded=!0,t.exports}l.m=n,l.c=i,e=[],l.O=(r,t,a,o)=>{if(!t){var n=1/0;for(d=0;d=o)&&Object.keys(l.O).every(e=>l.O[e](t[c]))?t.splice(c--,1):(i=!1,o0&&e[d-1][2]>o;d--)e[d]=e[d-1];e[d]=[t,a,o]},l.n=e=>{var r=e&&e.__esModule?()=>e.default:()=>e;return l.d(r,{a:r}),r},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,l.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);l.r(o);var n={};r=r||[null,t({}),t([]),t(t)];for(var i=2&a&&e;("object"==typeof i||"function"==typeof i)&&!~r.indexOf(i);i=t(i))Object.getOwnPropertyNames(i).forEach(r=>n[r]=()=>e[r]);return n.default=()=>e,l.d(o,n),o},l.d=(e,r)=>{for(var t in r)l.o(r,t)&&!l.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:r[t]})},l.f={},l.e=e=>Promise.all(Object.keys(l.f).reduce((r,t)=>(l.f[t](e,r),r),[])),l.u=e=>"assets/js/"+({48:"a94703ab",98:"a7bd4aaa",143:"674bbca5",401:"17896441",413:"1db64337",647:"5e95c892",742:"aba21aa0"}[e]||e)+"."+{48:"b8c77466",98:"3ba34601",143:"1ea8ce94",237:"447ba118",401:"a2525508",413:"18f4a9e2",647:"a3b66919",742:"4a552a5c"}[e]+".js",l.miniCssF=e=>{},l.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),a={},o="project-public-docs:",l.l=(e,r,t,n)=>{if(a[e])a[e].push(r);else{var i,c;if(void 0!==t)for(var u=document.getElementsByTagName("script"),d=0;d{i.onerror=i.onload=null,clearTimeout(b);var o=a[e];if(delete a[e],i.parentNode&&i.parentNode.removeChild(i),o&&o.forEach(e=>e(t)),r)return r(t)},b=setTimeout(s.bind(null,void 0,{type:"timeout",target:i}),12e4);i.onerror=s.bind(null,i.onerror),i.onload=s.bind(null,i.onload),c&&document.head.appendChild(i)}},l.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},l.p="/rob/development-hub/",l.gca=function(e){return e={17896441:"401",a94703ab:"48",a7bd4aaa:"98","674bbca5":"143","1db64337":"413","5e95c892":"647",aba21aa0:"742"}[e]||e,l.p+l.u(e)},(()=>{var e={354:0,869:0};l.f.j=(r,t)=>{var a=l.o(e,r)?e[r]:void 0;if(0!==a)if(a)t.push(a[2]);else if(/^(354|869)$/.test(r))e[r]=0;else{var o=new Promise((t,o)=>a=e[r]=[t,o]);t.push(a[2]=o);var n=l.p+l.u(r),i=new Error;l.l(n,t=>{if(l.o(e,r)&&(0!==(a=e[r])&&(e[r]=void 0),a)){var o=t&&("load"===t.type?"missing":t.type),n=t&&t.target&&t.target.src;i.message="Loading chunk "+r+" failed.\n("+o+": "+n+")",i.name="ChunkLoadError",i.type=o,i.request=n,a[1](i)}},"chunk-"+r,r)}},l.O.j=r=>0===e[r];var r=(r,t)=>{var a,o,[n,i,c]=t,u=0;if(n.some(r=>0!==e[r])){for(a in i)l.o(i,a)&&(l.m[a]=i[a]);if(c)var d=c(l)}for(r&&r(t);u{"use strict";var e,r,t,a,o,n={},i={};function l(e){var r=i[e];if(void 0!==r)return r.exports;var t=i[e]={id:e,loaded:!1,exports:{}};return n[e].call(t.exports,t,t.exports,l),t.loaded=!0,t.exports}l.m=n,l.c=i,e=[],l.O=(r,t,a,o)=>{if(!t){var n=1/0;for(d=0;d=o)&&Object.keys(l.O).every(e=>l.O[e](t[c]))?t.splice(c--,1):(i=!1,o0&&e[d-1][2]>o;d--)e[d]=e[d-1];e[d]=[t,a,o]},l.n=e=>{var r=e&&e.__esModule?()=>e.default:()=>e;return l.d(r,{a:r}),r},t=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,l.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);l.r(o);var n={};r=r||[null,t({}),t([]),t(t)];for(var i=2&a&&e;("object"==typeof i||"function"==typeof i)&&!~r.indexOf(i);i=t(i))Object.getOwnPropertyNames(i).forEach(r=>n[r]=()=>e[r]);return n.default=()=>e,l.d(o,n),o},l.d=(e,r)=>{for(var t in r)l.o(r,t)&&!l.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,get:r[t]})},l.f={},l.e=e=>Promise.all(Object.keys(l.f).reduce((r,t)=>(l.f[t](e,r),r),[])),l.u=e=>"assets/js/"+({48:"a94703ab",98:"a7bd4aaa",143:"674bbca5",401:"17896441",413:"1db64337",647:"5e95c892",742:"aba21aa0"}[e]||e)+"."+{48:"b8c77466",98:"3ba34601",143:"1ea8ce94",237:"447ba118",401:"a2525508",413:"e2b8ddcf",647:"a3b66919",742:"4a552a5c"}[e]+".js",l.miniCssF=e=>{},l.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),a={},o="project-public-docs:",l.l=(e,r,t,n)=>{if(a[e])a[e].push(r);else{var i,c;if(void 0!==t)for(var u=document.getElementsByTagName("script"),d=0;d{i.onerror=i.onload=null,clearTimeout(b);var o=a[e];if(delete a[e],i.parentNode&&i.parentNode.removeChild(i),o&&o.forEach(e=>e(t)),r)return r(t)},b=setTimeout(s.bind(null,void 0,{type:"timeout",target:i}),12e4);i.onerror=s.bind(null,i.onerror),i.onload=s.bind(null,i.onload),c&&document.head.appendChild(i)}},l.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},l.p="/rob/development-hub/",l.gca=function(e){return e={17896441:"401",a94703ab:"48",a7bd4aaa:"98","674bbca5":"143","1db64337":"413","5e95c892":"647",aba21aa0:"742"}[e]||e,l.p+l.u(e)},(()=>{var e={354:0,869:0};l.f.j=(r,t)=>{var a=l.o(e,r)?e[r]:void 0;if(0!==a)if(a)t.push(a[2]);else if(/^(354|869)$/.test(r))e[r]=0;else{var o=new Promise((t,o)=>a=e[r]=[t,o]);t.push(a[2]=o);var n=l.p+l.u(r),i=new Error;l.l(n,t=>{if(l.o(e,r)&&(0!==(a=e[r])&&(e[r]=void 0),a)){var o=t&&("load"===t.type?"missing":t.type),n=t&&t.target&&t.target.src;i.message="Loading chunk "+r+" failed.\n("+o+": "+n+")",i.name="ChunkLoadError",i.type=o,i.request=n,a[1](i)}},"chunk-"+r,r)}},l.O.j=r=>0===e[r];var r=(r,t)=>{var a,o,[n,i,c]=t,u=0;if(n.some(r=>0!==e[r])){for(a in i)l.o(i,a)&&(l.m[a]=i[a]);if(c)var d=c(l)}for(r&&r(t);u Development Hub - + @@ -14,13 +14,27 @@

Development Hub

Central orchestration project for managing Rob's multi-project development ecosystem.

Overview​

-

Development Hub provides tooling to create and manage projects that follow consistent patterns:

+

Development Hub provides:

    -
  • Centralized documentation via Docusaurus
    • -
  • Gitea repository hosting with Pages support
    • -
  • AI-assistant context files (CLAUDE.md)
    • -
  • Python project structure
    • +
  • GUI Application - PyQt6 workspace with project list, splittable terminal panes, and session persistence
    • +
  • CLI Tools - Scripts to create and manage projects following consistent patterns
    • +
  • Centralized Documentation - Docusaurus-based docs with Gitea Pages deployment
+

GUI Application​

+

A PyQt6-based workspace for managing your development projects.

+

Running the App​

+
cd ~/PycharmProjects/development-hub
source .venv/bin/activate
python -m development_hub
+

Features​

+
    +
  • Project List - Auto-discovers projects, right-click for actions (terminal, editor, Gitea, docs, deploy)
    • +
  • Splittable Panes - Horizontal/vertical splits, each pane has its own tab bar
    • +
  • PTY Terminals - Full terminal emulation with TUI support (vim, htop work)
    • +
  • Drag & Drop - Drop files/folders into terminal to inject paths
    • +
  • Session Persistence - Remembers pane layout and open terminals on restart
    • +
  • New Project Dialog - Create projects with optional Ramble voice input
    • +
+

Keyboard Shortcuts​

+
ShortcutAction
Ctrl+Shift+TNew terminal tab
Ctrl+Shift+WClose current tab
Ctrl+Shift+DSplit horizontal
Ctrl+Shift+ESplit vertical
Ctrl+Alt+Left/RightSwitch panes
Ctrl+BToggle project panel
Ctrl+NNew project dialog

The new-project Script​

The main tool is new-project, which automates creating a new project in the ecosystem:

new-project my-tool --title "My Tool" --tagline "Does useful things"
@@ -42,7 +56,7 @@

Usage​

# Full specification
new-project myproject --title "My Project" --tagline "Short description"

# Interactive mode (prompts for title/tagline)
new-project myproject

# Options
--dry-run       Show what would happen without making changes
--skip-gitea    Skip Gitea repo creation (for offline use)
--help          Show help

Project Structure​

-
development-hub/
├── bin/
│   └── new-project           # Main scaffolding script
├── templates/
│   ├── gitignore.template
│   ├── CLAUDE.md.template
│   ├── README.md.template
│   ├── pyproject.toml.template
│   ├── overview.md.template
│   └── updating-documentation.md.template
├── docs/                     # Symlink to this folder
├── CLAUDE.md
├── README.md
└── .gitignore
+
development-hub/
├── src/development_hub/      # GUI application
│   ├── main_window.py        # Main window with menus
│   ├── project_list.py       # Project discovery & context menu
│   ├── workspace.py          # Splittable pane layout
│   ├── terminal_widget.py    # PTY terminal with pyte
│   ├── dialogs.py            # New Project, Settings dialogs
│   └── ...
├── bin/
│   └── new-project           # CLI scaffolding script
├── templates/                # Project templates
├── docs/                     # Symlink to this folder
├── pyproject.toml
├── CLAUDE.md
└── README.md

Configuration​

Gitea API Token​

The script needs a Gitea API token to create repositories automatically.

@@ -61,6 +75,6 @@

Development Hub manages these projects:

ProjectDescription
CmdForgeAI-powered CLI tool builder
CascadingDevCascading Development Framework
Orchestrated DiscussionsAI Discussion Framework
Artifact EditorCode Artifact Editor
RambleVoice Note Transcription
-

All projects follow the same patterns and can be created using new-project.

+

All projects follow the same patterns and can be created using new-project.

\ No newline at end of file