Seedbury Square - User contributions [en]

The Dungeon

2026-06-23T15:09:18Z

Adr-seedbury: /* Current resident(s) */

[[File:Dungeon.jpg|thumb|border|upright 1.0|Hallway to the dungeon]]

The dungeon is the room at the end of the hallway in the current Seedbury Square office. It was deemed [https://wiki.seedburysquare.com/index.php/The_Dungeon the dungeon] as an internal joke because it's previous inhabitants would refuse to turn on the lights and the lack of windows and powerful A/C would give the feeling of a prison cell in a castle in the year 1819.

== Former residents ==

* Edwin Borrero
* Jorge Pacheco

== Current resident(s) ==

* Estefany Santiago
* Eduardo Valladares

Setup Steps

2026-01-08T18:18:34Z

Adr-seedbury: code syntax and added setting user.name and user.email

== Amazon Workspaces ==
Username and password provided by admin. This password also corresponds to "Keyring" password inside the workspace.
== Gitea ==
Gitea is the issue tracking and version control interface used for development in Ksitropy.

To access gitea, enter the following in the browser of your choice: '''172.31.108.186:3000''' (remember to bookmark it for easy access).

Create an account (YOUR_INITIALS-seedbury), admin will invite you to Ksitropy repository.

== VSCode ==
=== Initial Setup ===
# Run <code>git config --global credential.helper store</code>. This will store your git credentials the next time you input them.
# Run <code>git config --global user.name "YOUR_NAME_HERE"</code> and <code>git config --global user.email "YOUR_EMAIL_HERE"</code>.
# Create a "Projects" folder inside the "Documents" Folder.
# Inside this folder, clone the Ksitropy repository.
## Visit the repository in Gitea.
## Under Code, copy the HTTP link.
## Inside the "Projects" folder run <code>git clone PASTE_HTTP_LINK_HERE</code>
# Create env.js file inside the api folder.
# Paste <code>export default { group: 0, id: 'dev0'};</code>

=== User Settings and Aliases ===
# Press control+shift+p and type 'Open User Settings (JSON)'.
# In the resulting file, paste [[global user settings json]].
# In the terminal, run ''code ~/.bash_aliases''
# In the resulting file, paste the [[bash aliases code]].
# In the pasted code, insert your own Gitea token:
## Go to Gitea.
## Go to Settings -> Applications.
## Under Generate New Token:
### Input a token name of your liking.
### Check 'All (public, private, and limited)'.
### Under Select permissions, set all to 'Read and Write'.
## Click Generate Token button.
## Copy the token in the blue box.
## Paste in the bash aliases file where it says <get token in gitea> surrounded by quotes.

=== Running the app with debugger ===
# In the debugger, press the link to create a launch.json file.
# Press enter to select the default option (Node.js).
# In that file, paste the code in [[launch.json code]].
# In that folder, create another file named tasks.json and paste the code in [[tasks.json code]].

To run the development build, choose ''Dev: server + browser'' in the debugger and run it.

== Create a Ksitropy account ==
In the development website, create an account using the work email and a password of your choice. Remember or write down these credentials. An admin will activate your account.
== Neo4j ==
Neo4j is used to interact with the graph database that is used in Ksitropy.

You can find it in '''172.31.106.81:7474/browser/preview''', remember to bookmark it for easy access.

The connection information can be found in envSettings.js under graphDatabaseSettings

Bash aliases code

2026-01-08T18:11:32Z

Adr-seedbury:

<pre>
alias edit="code ~/.bash_aliases"

function mergeFrom() {
currentBranch=$(git rev-parse --abbrev-ref HEAD)
git checkout "${1:-Development}"
git pull
git checkout "${2:-$currentBranch}"
git merge "${1:-Development}"
}

function commitAndPush(){
git add . && git commit -a -m "$1" && git push
}

export GITEA_TOKEN=<get token in gitea>

# ====== MINIMAL GITEA HELPERS (env-driven, non-interactive) ======

export DEFAULT_BASE_BRANCH="${DEFAULT_BASE_BRANCH:-Development}"
# Required for real API calls:
# export GITEA_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Required repo coordinates (set these once; no parsing logic):
export GITEA_BASE="http://172.31.108.186:3000" # include subpath if any, no trailing slash
# export GITEA_OWNER="Seedbury_Square"
# export GITEA_REPO="Ksitropy"
# Debug without sending requests:
# export DRYRUN=1

# --- smart environment resolver: uses env if set, otherwise parses remote.origin.url ---
__resolve_env() {
# Ensure base always exists
: "${GITEA_BASE:?ERR: GITEA_BASE must be set (e.g. http://172.31.108.186:3000)}"

# If OWNER/REPO already set, skip parsing
if [ -n "$GITEA_OWNER" ] && [ -n "$GITEA_REPO" ]; then
return 0
fi

# Otherwise, derive from git remote
local remote path
remote="$(git config --get remote.origin.url 2>/dev/null)" || {
echo "ERR: not a git repo or missing origin remote" >&2
return 1
}
[ -n "$remote" ] || { echo "ERR: remote.origin.url empty" >&2; return 1; }

# Extract path (Owner/Repo)
path="$(printf '%s' "$remote" | sed -E 's#^[^:]+://[^/]+/##; s#^[^@]+@[^:]+:##')"
path="${path%.git}"

GITEA_OWNER="${path%%/*}"
GITEA_REPO="${path##*/}"
}

__need_env() {
__resolve_env || return 1
: "${GITEA_OWNER:?ERR: could not resolve OWNER}"
: "${GITEA_REPO:?ERR: could not resolve REPO}"
}

__need_token() { [ "${DRYRUN:-0}" = "1" ] && return 0; : "${GITEA_TOKEN:?ERR: set GITEA_TOKEN}"; }
__json_num() { grep -oE '"(index|number)"[[:space:]]*:[[:space:]]*[0-9]+' | head -n1 | grep -oE '[0-9]+'; }

showRepo() {
__need_env || return 1
echo "HOST=${GITEA_BASE%/}"
echo "OWNER=$GITEA_OWNER"
echo "REPO=$GITEA_REPO"
echo -n "API check: "
curl -fsS "${GITEA_BASE%/}/api/v1/version" && echo " (OK)"
}

# makeBranch <branch> [base]
makeBranch() {
local br="${1:?Usage: makeBranch <branch> [base]}"
local base="${2:-$DEFAULT_BASE_BRANCH}"
if git rev-parse --verify --quiet "$br" >/dev/null; then
git checkout "$br"
else
git checkout "$base" || return 1
git pull --ff-only || return 1
git checkout -b "$br" || return 1
git push --set-upstream origin "$br"
fi
}

# makeIssue <title> [body] -> prints issue#
makeIssue() {
local title="${1:?Usage: makeIssue <title> [body]}"
local body="${2:-$title}"
__need_env || return 1
__need_token || return 1
local url="${GITEA_BASE%/}/api/v1/repos/$GITEA_OWNER/$GITEA_REPO/issues"
local data; data=$(printf '{"title":"%s","body":"%s"}' "$title" "$body")
echo "POST $url" >&2
if [ "${DRYRUN:-0}" = "1" ]; then echo "$data" >&2; return 0; fi
local resp num
resp="$(curl -fsS -X POST "$url" -H "Authorization: token $GITEA_TOKEN" -H "Content-Type: application/json" -d "$data")" || return 1
num="$(__json_num <<<"$resp")"
[ -n "$num" ] && { printf '%s\n' "$num"; return 0; }
echo "ERR: could not parse issue number" >&2; echo "$resp" >&2; return 1
}

# Usage: makePRFromCurrent <title> <body> <baseBranch>
makePRFromCurrent() {
local title="${1:?Usage: makePRFromCurrent <title> <body> <baseBranch>}"
local body="${2:-}"
local base="${3:-Development}"

# ✅ prepend "WIP:" if not already present
if [[ ! "$title" =~ ^WIP: ]]; then
title="WIP: $title"
fi

__need_env || return 1
__need_token || return 1

local branch
branch="$(git rev-parse --abbrev-ref HEAD)"
local url="${GITEA_BASE%/}/api/v1/repos/$GITEA_OWNER/$GITEA_REPO/pulls"

echo "POST $url" >&2
if [ "${DRYRUN:-0}" = "1" ]; then
echo "{\"head\":\"$branch\",\"base\":\"$base\",\"title\":\"$title\",\"body\":\"$body\"}"
echo "<PR_NUM>"
return 0
fi

curl -fsS -X POST "$url" \
-H "Authorization: token $GITEA_TOKEN" \
-H "Content-Type: application/json" \
-d "$(jq -nc \
--arg head "$branch" \
--arg base "$base" \
--arg title "$title" \
--arg body "$body" \
'{head:$head, base:$base, title:$title, body:$body}')" |
tee /tmp/tea_pr_create.json |
jq -r '.number'
}

# linkIssueDependsOnPR <issue#> <pr#>
linkIssueDependsOnPR() {
local issue="${1:?Usage: linkIssueDependsOnPR <issue#> <pr#>}"
local pr="${2:?Usage: linkIssueDependsOnPR <issue#> <pr#>}"
__need_env || return 1
__need_token || return 1
local url="${GITEA_BASE%/}/api/v1/repos/$GITEA_OWNER/$GITEA_REPO/issues/$issue/dependencies"
local data; data=$(printf '{"owner":"%s","repo":"%s","index":%s}' "$GITEA_OWNER" "$GITEA_REPO" "$pr")
echo "POST $url" >&2
if [ "${DRYRUN:-0}" = "1" ]; then echo "$data" >&2; return 0; fi
curl -fsS -X POST "$url" -H "Authorization: token $GITEA_TOKEN" -H "Content-Type: application/json" -d "$data" >/dev/null
}
__issue_title() {
local idx="${1:?Usage: __issue_title <issue#>}"
__need_env || return 1
__need_token || return 1
local url="${GITEA_BASE%/}/api/v1/repos/$GITEA_OWNER/$GITEA_REPO/issues/$idx"
echo "GET $url" >&2
if [ "${DRYRUN:-0}" = "1" ]; then
echo "<ISSUE_TITLE>" # placeholder in dryrun
return 0
fi
curl -fsS "$url" -H "Authorization: token $GITEA_TOKEN" \
| sed -n 's/.*"title"[[:space:]]*:[[:space:]]*"$[^"]*$".*/\1/p' | head -n1
}
# startWork <branch> [description]
startWork() {
# ---------------------------------------------------------------------------
# startWork: Create a new Issue, branch, and PR following the team workflow.
#
# Usage:
# startWork <branchBase> <title> [description]
#
# Example:
# startWork api-endpoint "Implement new API endpoint" "Adds user data retrieval"
#
# Options:
# --help Show this help message and exit.
#
# Environment Variables:
# DRYRUN=1 Prints all operations without executing.
# DEFAULT_BASE_BRANCH Base branch name (default: main or develop).
#
# Workflow Steps:
# 1. Create an issue with the given title and optional description.
# 2. Create a branch named "<issueNumber>-<branchBase>".
# 3. Create a pull request titled the same as the issue.
# 4. Link the PR and Issue as dependencies.
# ---------------------------------------------------------------------------

# --- Handle help flag ------------------------------------------------------
if [[ "$1" == "--help" || "$1" == "-h" ]]; then
sed -n '2,25p' "${BASH_SOURCE[0]}" | sed 's/^ # //'
return 0
fi

local branch_base="${1:?Usage: startWork <branchBase> <title> [description]}"
local title="${2:?Usage: startWork <branchBase> <title> [description]}"
local desc="${3:-}" # optional description/comment

local pr_body
if [ -n "$desc" ]; then pr_body="$desc"; else pr_body=""; fi

if [ "${DRYRUN:-0}" = "1" ]; then
echo "==> DRYRUN: will create Issue(title='$title'), then branch 'NNN-$branch_base', then PR(title='$title')"
showRepo || true
echo "==> Creating issue"; makeIssue "$title" "$desc"
echo "==> Creating branch 'NNN-$branch_base' (base: ${DEFAULT_BASE_BRANCH})"
echo "git checkout ${DEFAULT_BASE_BRANCH} && git pull --ff-only && git checkout -b NNN-$branch_base && git push --set-upstream origin NNN-$branch_base"
echo "==> Creating PR"; local prBody="$pr_body"$'\n\n'"Closes #<NNN>"
makePRFromCurrent "$title" "$prBody" "$DEFAULT_BASE_BRANCH"
echo "==> Linking dependency"; linkIssueDependsOnPR "<NNN>" "<PR_NUM>"
return 0
fi

echo "==> Creating issue"
local issue; issue="$(makeIssue "$title" "$desc")" || return 1
echo "Created issue #$issue"

local branch="${issue}-${branch_base}"

echo "==> Creating branch '$branch' (base: ${DEFAULT_BASE_BRANCH})"
makeBranch "$branch" "$DEFAULT_BASE_BRANCH" || return 1

echo "==> Creating PR"
local prBody="$pr_body"
[ -n "$prBody" ] && prBody="$prBody"$'\n\n'"Closes #$issue" || prBody="Closes #$issue"
local pr; pr="$(makePRFromCurrent "$title" "$prBody" "$DEFAULT_BASE_BRANCH")" || return 1
echo "Created PR #$pr"

echo "==> Linking dependency (issue #$issue depends on PR #$pr)"
linkIssueDependsOnPR "$issue" "$pr" || { echo "WARN: failed to add dependency" >&2; return 1; }

echo "✅ Done. Branch: $branch | Issue #$issue | PR #$pr"
}

# Usage: startFromIssue <branchBase> <issueNumber> [titleOverride] [description]
startFromIssue() {
local branch_base="${1:?Usage: startFromIssue <branchBase> <issueNumber> [titleOverride] [description] }"
local issue="${2:?Usage: startFromIssue <branchBase> <issueNumber> [titleOverride] [description] }"
local title_override="${3:-}"
local desc="${4:-}"

local title
if [ -n "$title_override" ]; then
title="$title_override"
else
title="$(__issue_title "$issue")" || return 1
[ -n "$title" ] || { echo "ERR: could not fetch title for issue #$issue" >&2; return 1; }
fi

local branch="${issue}-${branch_base}"

if [ "${DRYRUN:-0}" = "1" ]; then
echo "==> DRYRUN: will create branch '$branch' from issue #$issue, PR titled '$title'"
showRepo || true
echo "==> Creating branch '$branch' (base: ${DEFAULT_BASE_BRANCH})"
echo "git checkout ${DEFAULT_BASE_BRANCH} && git pull --ff-only && git checkout -b ${branch} && git push --set-upstream origin ${branch}"
echo "==> Creating PR"; local prBody="${desc}"$'\n\n'"Closes #$issue"; makePRFromCurrent "$title" "$prBody" "$DEFAULT_BASE_BRANCH"
echo "==> Linking dependency"; linkIssueDependsOnPR "$issue" "<PR_NUM>"
return 0
fi

echo "==> Creating branch '$branch' (base: ${DEFAULT_BASE_BRANCH})"
makeBranch "$branch" "$DEFAULT_BASE_BRANCH" || return 1

echo "==> Creating PR"
local prBody
[ -n "$desc" ] && prBody="$desc"$'\n\n'"Closes #$issue" || prBody="Closes #$issue"
local pr; pr="$(makePRFromCurrent "$title" "$prBody" "$DEFAULT_BASE_BRANCH")" || return 1
echo "Created PR #$pr"

echo "==> Linking dependency (issue #$issue depends on PR #$pr)"
linkIssueDependsOnPR "$issue" "$pr" || { echo "WARN: failed to add dependency" >&2; return 1; }

echo "✅ Done. Branch: $branch | Issue #$issue | PR #$pr"
}
# ====== END ======
</pre>

Setup Steps

2026-01-08T15:25:52Z

Adr-seedbury: visual change

== Amazon Workspaces ==
Username and password provided by admin. This password also corresponds to "Keyring" password inside the workspace.
== Gitea ==
Gitea is the issue tracking and version control interface used for development in Ksitropy.

To access gitea, enter the following in the browser of your choice: '''172.31.108.186:3000''' (remember to bookmark it for easy access).

Create an account (YOUR_INITIALS-seedbury), admin will invite you to Ksitropy repository.

== VSCode ==
=== Initial Setup ===
# Run ''git config --global credential.helper store''. This will store your git credentials the next time you input them.
# Create a "Projects" folder inside the "Documents" Folder.
# Inside this folder, clone the Ksitropy repository.
## Visit the repository in Gitea.
## Under Code, copy the HTTP link.
## Inside the "Projects" folder run ''git clone PASTE_HTTP_LINK_HERE''
# Create env.js file inside the api folder.
# Paste <code>export default { group: 0, id: 'dev0'};</code>

=== User Settings and Aliases ===
# Press control+shift+p and type 'Open User Settings (JSON)'.
# In the resulting file, paste [[global user settings json]].
# In the terminal, run ''code ~/.bash_aliases''
# In the resulting file, paste the [[bash aliases code]].
# In the pasted code, insert your own Gitea token:
## Go to Gitea.
## Go to Settings -> Applications.
## Under Generate New Token:
### Input a token name of your liking.
### Check 'All (public, private, and limited)'.
### Under Select permissions, set all to 'Read and Write'.
## Click Generate Token button.
## Copy the token in the blue box.
## Paste in the bash aliases file where it says <get token in gitea> surrounded by quotes.

=== Running the app with debugger ===
# In the debugger, press the link to create a launch.json file.
# Press enter to select the default option (Node.js).
# In that file, paste the code in [[launch.json code]].
# In that folder, create another file named tasks.json and paste the code in [[tasks.json code]].

To run the development build, choose ''Dev: server + browser'' in the debugger and run it.

== Create a Ksitropy account ==
In the development website, create an account using the work email and a password of your choice. Remember or write down these credentials. An admin will activate your account.
== Neo4j ==
Neo4j is used to interact with the graph database that is used in Ksitropy.

You can find it in '''172.31.106.81:7474/browser/preview''', remember to bookmark it for easy access.

The connection information can be found in envSettings.js under graphDatabaseSettings

Launch.json code

2026-01-08T15:06:35Z

Adr-seedbury:

<pre>
{
"version": "0.2.0",
"configurations": [
/* --- Server (Node.js) --- */
{
"name": "Server: Node (inspect)",
"type": "pwa-node",
"request": "launch",
"program": "${workspaceFolder}/api/src/webServer/webserver.js",
"cwd": "${workspaceFolder}/api/src/webServer",
"runtimeArgs": [
"--inspect=9229"
],
"env": {
"NODE_ENV": "development"
},
"skipFiles": [
"<node_internals>/**"
],
"console": "integratedTerminal",
"restart": true, // auto-restart on crash
"autoAttachChildProcesses": true
// If using TypeScript/transpiled output, add:
// "outFiles": ["${workspaceFolder}/**/*.js", "!**/node_modules/**"]
},
/* --- Browser (Chrome) --- */
{
"name": "Client: Chrome to http://localhost:1338",
"type": "pwa-chrome",
"request": "launch",
"url": "http://localhost:1338",
"webRoot": "${workspaceFolder}",
// If your app bundles sources (Vizte/Webpack), uncomment to improve breakpoint mapping:
// "sourceMapPathOverrides": {
// "webpack:///./*": "${webRoot}/*",
// "webpack:///*": "${webRoot}/*",
// "vite:///src/*": "${webRoot}/src/*"
// }
"skipFiles": [
"**/node_modules/**/*.js"
]
},
/* --- Optional: Node with nodemon (hot reload) --- */
{
"name": "Server: Node + nodemon (inspect)",
"type": "pwa-node",
"request": "launch",
"runtimeExecutable": "npx",
"runtimeArgs": [
"nodemon",
"--"
], // <-- 'nodemon' + '--' are the key
"args": [
"--inspect=9229",
"--signal",
"SIGTERM",
"${workspaceFolder}/api/src/webServer/webserver.js"
],
"cwd": "${workspaceFolder}/api/src/webServer",
"env": {
"NODE_ENV": "development"
},
"restart": true,
"console": "integratedTerminal",
"autoAttachChildProcesses": true
},
/* --- Optional: attach to an already-running Node --- */
{
"name": "Attach: Node on 9229",
"type": "pwa-node",
"request": "attach",
"port": 9229
},
{
"name": "Client: Chrome via BrowserSync",
"type": "pwa-chrome",
"request": "launch",
"url": "http://localhost:3000",
"webRoot": "${workspaceFolder}/api/src/webServer/ui",
"skipFiles": [
"**/node_modules/**/*.js"
],
"preLaunchTask": "browser-sync" // <- if compound preLaunchTask isn't honored, keep it here
}
],
"compounds": [
{
"name": "Dev: Nodemon + BrowserSync + Chrome",
"configurations": [
"Server: Node + nodemon (inspect)",
"Client: Chrome via BrowserSync"
],
"preLaunchTask": "browser-sync",
"stopAll": true
},
{
"name": "Dev: Server + Browser",
"configurations": [
"Server: Node (inspect)",
"Client: Chrome to http://localhost:1338"
],
"stopAll": true
},
{
"name": "Dev: Nodemon + Browser",
"configurations": [
"Server: Node + nodemon (inspect)",
"Client: Chrome to http://localhost:1338"
],
"stopAll": true
}
]
}
</pre>