xtruct 0.1.0__py3-none-any.whl
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.
- xtruct/__init__.py +3 -0
- xtruct/__main__.py +5 -0
- xtruct/_cli/bin/xtruct-foundry.js +3 -0
- xtruct/_cli/bin/xtruct.js +541 -0
- xtruct/_cli/global/claude-md-block.md +5 -0
- xtruct/_cli/global/skills/foundry/SKILL.md +46 -0
- xtruct/_cli/lib/dashboard.html +326 -0
- xtruct/_cli/lib/dashboard.js +212 -0
- xtruct/_cli/lib/paths.js +17 -0
- xtruct/_cli/lib/setup.js +136 -0
- xtruct/_cli/lib/tracker.js +155 -0
- xtruct/_cli/lib/ui.js +95 -0
- xtruct/_cli/package.json +44 -0
- xtruct/_cli/template/.claude/agents/architect.md +35 -0
- xtruct/_cli/template/.claude/agents/integrator.md +16 -0
- xtruct/_cli/template/.claude/agents/junior-dev.md +31 -0
- xtruct/_cli/template/.claude/agents/qa-lead.md +17 -0
- xtruct/_cli/template/.claude/agents/reviewer.md +23 -0
- xtruct/_cli/template/.claude/agents/senior-lead.md +29 -0
- xtruct/_cli/template/.claude/hooks/guard-bash.sh +38 -0
- xtruct/_cli/template/.claude/hooks/guard-files.sh +24 -0
- xtruct/_cli/template/.claude/settings.json +39 -0
- xtruct/_cli/template/.claude/skills/run-epics/SKILL.md +45 -0
- xtruct/_cli/template/.claude/workflows/plan-product.js +136 -0
- xtruct/_cli/template/.claude/workflows/run-epic.js +248 -0
- xtruct/_cli/template/.github/pull_request_template.md +24 -0
- xtruct/_cli/template/CLAUDE.md +65 -0
- xtruct/_cli/template/Makefile +8 -0
- xtruct/_cli/template/_gitignore +13 -0
- xtruct/_cli/template/contracts/README.md +4 -0
- xtruct/_cli/template/docs/CONVENTIONS.md +3 -0
- xtruct/_cli/template/docs/templates/ARCHITECTURE.md +30 -0
- xtruct/_cli/template/docs/templates/PRD.md +25 -0
- xtruct/_cli/template/docs/templates/ci.yml +22 -0
- xtruct/_cli/template/foundry.config.json +25 -0
- xtruct/_cli/template/scripts/bootstrap-github.sh +48 -0
- xtruct/_cli/template/scripts/capacity.mjs +53 -0
- xtruct/_cli/template/scripts/merge-pr.sh +97 -0
- xtruct/launcher.py +56 -0
- xtruct-0.1.0.dist-info/METADATA +41 -0
- xtruct-0.1.0.dist-info/RECORD +44 -0
- xtruct-0.1.0.dist-info/WHEEL +4 -0
- xtruct-0.1.0.dist-info/entry_points.txt +2 -0
- xtruct-0.1.0.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# <Product> — PRD
|
|
2
|
+
|
|
3
|
+
## Problem
|
|
4
|
+
Who has it, how they solve it today, why that's not good enough.
|
|
5
|
+
|
|
6
|
+
## Users
|
|
7
|
+
Primary and secondary personas, and what each needs to get done.
|
|
8
|
+
|
|
9
|
+
## MVP scope
|
|
10
|
+
Numbered capabilities, in priority order.
|
|
11
|
+
|
|
12
|
+
## Non-goals
|
|
13
|
+
What we are explicitly not building in the MVP.
|
|
14
|
+
|
|
15
|
+
## User flows
|
|
16
|
+
One section per flow: trigger → steps → outcome.
|
|
17
|
+
|
|
18
|
+
### Acceptance criteria
|
|
19
|
+
Per flow, testable statements: "Given …, when …, then …".
|
|
20
|
+
|
|
21
|
+
## Success metrics
|
|
22
|
+
How the founder will know it works.
|
|
23
|
+
|
|
24
|
+
## Open questions
|
|
25
|
+
Decisions the founder still needs to make.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Foundation copies this to .github/workflows/ci.yml and fills in the toolchain steps.
|
|
2
|
+
# Keep the job name "ci": branch protection and the merge gate depend on it.
|
|
3
|
+
name: ci
|
|
4
|
+
on:
|
|
5
|
+
pull_request:
|
|
6
|
+
push:
|
|
7
|
+
branches: [main]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
ci:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
timeout-minutes: 30
|
|
13
|
+
steps:
|
|
14
|
+
- uses: actions/checkout@v4
|
|
15
|
+
# Toolchain setup for the chosen stack, e.g.:
|
|
16
|
+
# - uses: pnpm/action-setup@v4
|
|
17
|
+
# - uses: actions/setup-node@v4
|
|
18
|
+
# with: { node-version: 22, cache: pnpm }
|
|
19
|
+
# - uses: astral-sh/setup-uv@v5
|
|
20
|
+
# Services (Postgres, Redis) via `services:` if tests need them.
|
|
21
|
+
- run: make setup
|
|
22
|
+
- run: make ci
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"product": "",
|
|
3
|
+
"clickup": {
|
|
4
|
+
"workspace_id": "",
|
|
5
|
+
"space_id": "",
|
|
6
|
+
"space_name": "",
|
|
7
|
+
"folder_id": "",
|
|
8
|
+
"epics_list_id": ""
|
|
9
|
+
},
|
|
10
|
+
"github": {
|
|
11
|
+
"repo": ""
|
|
12
|
+
},
|
|
13
|
+
"limits": {
|
|
14
|
+
"max_pr_lines": 800,
|
|
15
|
+
"strict_merge": false,
|
|
16
|
+
"agents_per_core": 1.5,
|
|
17
|
+
"ram_per_agent_gb": 1.5,
|
|
18
|
+
"reserve_ram_gb": 6,
|
|
19
|
+
"max_agents": null
|
|
20
|
+
},
|
|
21
|
+
"foundry_version": "",
|
|
22
|
+
"integrations": {
|
|
23
|
+
"xtruct": "auto"
|
|
24
|
+
}
|
|
25
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Founder-only. Creates the private GitHub repo, pushes main, adds labels, protects main.
|
|
3
|
+
# Usage: scripts/bootstrap-github.sh first run, after approving the spec
|
|
4
|
+
# scripts/bootstrap-github.sh --require-ci after Foundation adds CI: make the "ci" check required
|
|
5
|
+
set -euo pipefail
|
|
6
|
+
|
|
7
|
+
cd "$(git rev-parse --show-toplevel)"
|
|
8
|
+
require_ci=0; [ "${1:-}" = --require-ci ] && require_ci=1
|
|
9
|
+
name=$(jq -r .product foundry.config.json)
|
|
10
|
+
|
|
11
|
+
if ! git remote get-url origin >/dev/null 2>&1; then
|
|
12
|
+
gh repo create "$name" --private --source . --push
|
|
13
|
+
fi
|
|
14
|
+
repo=$(gh repo view --json nameWithOwner -q .nameWithOwner)
|
|
15
|
+
|
|
16
|
+
if [ "$(jq -r '.github.repo // ""' foundry.config.json)" != "$repo" ]; then
|
|
17
|
+
jq --arg r "$repo" '.github.repo = $r' foundry.config.json > foundry.config.json.tmp
|
|
18
|
+
mv foundry.config.json.tmp foundry.config.json
|
|
19
|
+
git add foundry.config.json && git commit -qm "chore: record GitHub repo"
|
|
20
|
+
fi
|
|
21
|
+
git push -q -u origin main
|
|
22
|
+
|
|
23
|
+
label() { gh label create "$1" --color "$2" --description "$3" --force >/dev/null; }
|
|
24
|
+
label review:passed 0E8A16 "Reviewer agent approved"
|
|
25
|
+
label lead:approved 1D76DB "Senior lead approved for spec fit"
|
|
26
|
+
label large-ok FBCA04 "Lead allowed an oversized PR"
|
|
27
|
+
label founder-approved B60205 "Founder approved (founder-only)"
|
|
28
|
+
label bug D93F0B "Defect found by QA"
|
|
29
|
+
|
|
30
|
+
checks=null
|
|
31
|
+
[ $require_ci = 1 ] && checks='{"strict": false, "contexts": ["ci"]}'
|
|
32
|
+
if gh api -X PUT "repos/$repo/branches/main/protection" --input - >/dev/null <<JSON
|
|
33
|
+
{
|
|
34
|
+
"required_status_checks": $checks,
|
|
35
|
+
"enforce_admins": true,
|
|
36
|
+
"required_pull_request_reviews": { "required_approving_review_count": 0 },
|
|
37
|
+
"restrictions": null,
|
|
38
|
+
"allow_force_pushes": false,
|
|
39
|
+
"allow_deletions": false
|
|
40
|
+
}
|
|
41
|
+
JSON
|
|
42
|
+
then
|
|
43
|
+
echo "main is protected (PRs required, no force-push$([ $require_ci = 1 ] && echo ', ci check required'))."
|
|
44
|
+
else
|
|
45
|
+
echo "warning: could not protect main. Private repos on a free personal plan need GitHub Pro for branch protection." >&2
|
|
46
|
+
echo "The merge gate and hooks still apply; GitHub just won't enforce them server-side." >&2
|
|
47
|
+
fi
|
|
48
|
+
echo "Repo: https://github.com/$repo"
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// How many agents this machine can run at once, and how to split them across epic workflows.
|
|
3
|
+
// Prints JSON. Used by the run-epics skill and by `xtruct capacity`.
|
|
4
|
+
//
|
|
5
|
+
// Agents mostly wait on the model; local load comes from what they run (installs, builds, tests).
|
|
6
|
+
// So the budget is set by RAM per agent and by CPU headroom, whichever is tighter.
|
|
7
|
+
// Tune per product in foundry.config.json → limits: ram_per_agent_gb, reserve_ram_gb, agents_per_core, max_agents.
|
|
8
|
+
import fs from 'node:fs'
|
|
9
|
+
import os from 'node:os'
|
|
10
|
+
import path from 'node:path'
|
|
11
|
+
|
|
12
|
+
function readLimits() {
|
|
13
|
+
for (let dir = process.cwd(); ; dir = path.dirname(dir)) {
|
|
14
|
+
const file = path.join(dir, 'foundry.config.json')
|
|
15
|
+
if (fs.existsSync(file)) return JSON.parse(fs.readFileSync(file, 'utf8')).limits ?? {}
|
|
16
|
+
if (path.dirname(dir) === dir) return {}
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
const limits = readLimits()
|
|
21
|
+
const cpus = os.availableParallelism?.() ?? os.cpus().length
|
|
22
|
+
const ramGb = os.totalmem() / 2 ** 30
|
|
23
|
+
const load = os.platform() === 'win32' ? 0 : os.loadavg()[0]
|
|
24
|
+
|
|
25
|
+
const ramPerAgent = limits.ram_per_agent_gb ?? 1.5
|
|
26
|
+
const reserveRam = limits.reserve_ram_gb ?? 6
|
|
27
|
+
// Each CPU core can host ~1.5 agents by default, because most of an agent's time is spent waiting on the model.
|
|
28
|
+
const agentsPerCore = limits.agents_per_core ?? 1.5
|
|
29
|
+
// A typical epic has about this many tasks runnable at once; used to decide how many epics to run side by side.
|
|
30
|
+
const TYPICAL_EPIC_WIDTH = 8
|
|
31
|
+
|
|
32
|
+
const byRam = Math.floor((ramGb - reserveRam) / ramPerAgent)
|
|
33
|
+
const byCpu = Math.floor(Math.max(1, cpus - load) * agentsPerCore)
|
|
34
|
+
const caps = { ram: byRam, cpu: byCpu }
|
|
35
|
+
if (Number.isInteger(limits.max_agents) && limits.max_agents > 0) caps.max_agents = limits.max_agents
|
|
36
|
+
const [limitedBy, budget] = Object.entries(caps).sort((a, b) => a[1] - b[1])[0]
|
|
37
|
+
const total = Math.max(1, budget)
|
|
38
|
+
|
|
39
|
+
// Claude Code's workflow runtime runs at most min(16, cores - 2) agents per workflow.
|
|
40
|
+
const perWorkflowCeiling = Math.max(1, Math.min(16, cpus - 2))
|
|
41
|
+
const epicsAtOnce = Math.max(1, Math.floor(total / TYPICAL_EPIC_WIDTH))
|
|
42
|
+
const agentsPerEpic = Math.min(perWorkflowCeiling, Math.max(1, Math.floor(total / epicsAtOnce)))
|
|
43
|
+
|
|
44
|
+
console.log(JSON.stringify({
|
|
45
|
+
cpus,
|
|
46
|
+
ram_gb: Math.round(ramGb),
|
|
47
|
+
load_1m: Math.round(load * 10) / 10,
|
|
48
|
+
total_agents: total,
|
|
49
|
+
limited_by: limitedBy,
|
|
50
|
+
per_workflow_ceiling: perWorkflowCeiling,
|
|
51
|
+
epics_at_once: epicsAtOnce,
|
|
52
|
+
agents_per_epic: agentsPerEpic,
|
|
53
|
+
}, null, 2))
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Gated merge: the only sanctioned way to merge a PR.
|
|
3
|
+
# Usage: scripts/merge-pr.sh <pr-number>
|
|
4
|
+
# Exit: 0 merged, 2 gate rejected, 3 conflicts (rebase needed), 1 other error.
|
|
5
|
+
set -euo pipefail
|
|
6
|
+
|
|
7
|
+
PR=${1:?usage: scripts/merge-pr.sh <pr-number>}
|
|
8
|
+
root=$(git rev-parse --show-toplevel)
|
|
9
|
+
cfg="$root/foundry.config.json"
|
|
10
|
+
max_lines=$(jq -r '.limits.max_pr_lines // 800' "$cfg")
|
|
11
|
+
strict=$(jq -r '.limits.strict_merge // false' "$cfg")
|
|
12
|
+
|
|
13
|
+
reject() { echo "GATE REJECTED: $*" >&2; exit 2; }
|
|
14
|
+
|
|
15
|
+
view() { gh pr view "$PR" --json "$1"; }
|
|
16
|
+
json=$(view state,labels,body,files,headRefName,baseRefName,isDraft)
|
|
17
|
+
[ "$(jq -r .state <<<"$json")" = OPEN ] || reject "PR #$PR is not open"
|
|
18
|
+
[ "$(jq -r .isDraft <<<"$json")" = false ] || reject "PR #$PR is a draft"
|
|
19
|
+
[ "$(jq -r .baseRefName <<<"$json")" = main ] || reject "PR #$PR does not target main"
|
|
20
|
+
branch=$(jq -r .headRefName <<<"$json")
|
|
21
|
+
labels=$(jq -r '.labels[].name' <<<"$json")
|
|
22
|
+
has_label() { grep -qx -- "$1" <<<"$labels"; }
|
|
23
|
+
|
|
24
|
+
# 1. Approvals.
|
|
25
|
+
has_label review:passed || reject "missing label review:passed (reviewer approval)"
|
|
26
|
+
has_label lead:approved || reject "missing label lead:approved (senior lead approval)"
|
|
27
|
+
|
|
28
|
+
# 2. Scope: every changed file must match a glob in the PR body's <!-- scope ... --> block.
|
|
29
|
+
scope=$(jq -r .body <<<"$json" | awk '/<!-- *scope/{f=1;next} f&&/-->/{f=0} f' | sed 's/^[[:space:]-]*//;s/[[:space:]]*$//' | grep -v '^$' || true)
|
|
30
|
+
[ -n "$scope" ] || reject "PR body has no <!-- scope ... --> block"
|
|
31
|
+
lockfile_re='(lock\.(json|yaml)|\.lock|lock\.ya?ml)$'
|
|
32
|
+
out_of_scope=()
|
|
33
|
+
while IFS= read -r file; do
|
|
34
|
+
# Lockfiles are regenerated by the package manager; the integrator resolves their conflicts.
|
|
35
|
+
[[ $file =~ $lockfile_re ]] && continue
|
|
36
|
+
ok=0
|
|
37
|
+
while IFS= read -r glob; do
|
|
38
|
+
# shellcheck disable=SC2053 # glob match is intended; * also matches across /
|
|
39
|
+
[[ $file == $glob ]] && { ok=1; break; }
|
|
40
|
+
done <<<"$scope"
|
|
41
|
+
[ $ok = 1 ] || out_of_scope+=("$file")
|
|
42
|
+
done < <(jq -r '.files[].path' <<<"$json")
|
|
43
|
+
[ ${#out_of_scope[@]} = 0 ] || reject "files outside scope: ${out_of_scope[*]}"
|
|
44
|
+
|
|
45
|
+
# 3. Founder-only paths.
|
|
46
|
+
if jq -r '.files[].path' <<<"$json" | grep -Eq '^(\.claude/|CLAUDE\.md$|scripts/merge-pr\.sh$|scripts/bootstrap-github\.sh$|scripts/capacity\.mjs$)'; then
|
|
47
|
+
has_label founder-approved || reject "touches founder-only paths; needs the founder-approved label"
|
|
48
|
+
fi
|
|
49
|
+
|
|
50
|
+
# 4. Size, excluding lockfiles and generated snapshots.
|
|
51
|
+
lines=$(jq '[.files[] | select(.path | test("(lock\\.(json|yaml)|\\.lock|lock\\.ya?ml|\\.snap)$") | not) | .additions + .deletions] | add // 0' <<<"$json")
|
|
52
|
+
if [ "$lines" -gt "$max_lines" ] && ! has_label large-ok; then
|
|
53
|
+
reject "$lines changed lines exceeds $max_lines; split the task or get the lead's large-ok label"
|
|
54
|
+
fi
|
|
55
|
+
|
|
56
|
+
# 5. CI. Skipped only while main has no CI workflow yet (early Foundation tasks).
|
|
57
|
+
git fetch -q origin main
|
|
58
|
+
wait_ci() {
|
|
59
|
+
for _ in 1 2 3 4 5 6; do
|
|
60
|
+
out=$(gh pr checks "$PR" --watch --fail-fast --interval 20 2>&1) && return 0
|
|
61
|
+
grep -q 'no checks reported' <<<"$out" || { echo "$out" >&2; reject "CI is not green"; }
|
|
62
|
+
sleep 15
|
|
63
|
+
done
|
|
64
|
+
reject "CI never started for PR #$PR"
|
|
65
|
+
}
|
|
66
|
+
if git ls-tree --name-only origin/main .github/workflows/ | grep -q .; then
|
|
67
|
+
wait_ci
|
|
68
|
+
else
|
|
69
|
+
echo "warning: main has no CI workflow yet; skipping the CI gate" >&2
|
|
70
|
+
fi
|
|
71
|
+
|
|
72
|
+
# 6. Merge under a lock shared by every worktree and every running workflow.
|
|
73
|
+
lock="$(git rev-parse --git-common-dir)/foundry-merge.lock"
|
|
74
|
+
for _ in $(seq 1 360); do mkdir "$lock" 2>/dev/null && break; sleep 5; done
|
|
75
|
+
[ -d "$lock" ] || { echo "could not take merge lock $lock" >&2; exit 1; }
|
|
76
|
+
trap 'rmdir "$lock"' EXIT
|
|
77
|
+
|
|
78
|
+
state=UNKNOWN
|
|
79
|
+
for _ in 1 2 3 4 5; do
|
|
80
|
+
state=$(view mergeStateStatus | jq -r .mergeStateStatus)
|
|
81
|
+
[ "$state" != UNKNOWN ] && break
|
|
82
|
+
sleep 3
|
|
83
|
+
done
|
|
84
|
+
case "$state" in
|
|
85
|
+
DIRTY) echo "PR #$PR conflicts with main; rebase needed" >&2; exit 3 ;;
|
|
86
|
+
BEHIND)
|
|
87
|
+
if [ "$strict" = true ]; then
|
|
88
|
+
gh pr update-branch "$PR" >/dev/null
|
|
89
|
+
wait_ci
|
|
90
|
+
fi ;;
|
|
91
|
+
BLOCKED) reject "GitHub branch protection blocks PR #$PR (required checks or reviews)" ;;
|
|
92
|
+
esac
|
|
93
|
+
|
|
94
|
+
sha=$(gh api -X PUT "repos/{owner}/{repo}/pulls/$PR/merge" -f merge_method=squash --jq .sha) \
|
|
95
|
+
|| { echo "merge API call failed for PR #$PR" >&2; exit 1; }
|
|
96
|
+
gh api -X DELETE "repos/{owner}/{repo}/git/refs/heads/$branch" >/dev/null 2>&1 || true
|
|
97
|
+
echo "MERGED #$PR $sha"
|
xtruct/launcher.py
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
"""`xtruct` for Python environments: runs the bundled Xtruct CLI with Node.js.
|
|
2
|
+
|
|
3
|
+
The CLI itself is the same one published to npm as @masst/xtruct, copied into
|
|
4
|
+
this package at build time, so pip and npm installs always behave the same.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import os
|
|
8
|
+
import re
|
|
9
|
+
import shutil
|
|
10
|
+
import subprocess
|
|
11
|
+
import sys
|
|
12
|
+
from pathlib import Path
|
|
13
|
+
|
|
14
|
+
MIN_NODE = (18, 3)
|
|
15
|
+
CLI = Path(__file__).resolve().parent / "_cli" / "bin" / "xtruct.js"
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
def _node():
|
|
19
|
+
return os.environ.get("XTRUCT_NODE") or shutil.which("node")
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def _version(node):
|
|
23
|
+
try:
|
|
24
|
+
out = subprocess.run([node, "--version"], capture_output=True, text=True, timeout=10).stdout
|
|
25
|
+
except (OSError, subprocess.SubprocessError):
|
|
26
|
+
return None
|
|
27
|
+
m = re.match(r"v(\d+)\.(\d+)", out.strip())
|
|
28
|
+
return (int(m.group(1)), int(m.group(2))) if m else None
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def main():
|
|
32
|
+
if not CLI.is_file():
|
|
33
|
+
print("xtruct: this install is missing its bundled CLI. Reinstall the package.", file=sys.stderr)
|
|
34
|
+
return 1
|
|
35
|
+
node = _node()
|
|
36
|
+
if not node:
|
|
37
|
+
print(
|
|
38
|
+
"xtruct needs Node.js 18.3 or newer, and it isn't on your PATH.\n"
|
|
39
|
+
"Install it from https://nodejs.org, or set XTRUCT_NODE to a node binary.",
|
|
40
|
+
file=sys.stderr,
|
|
41
|
+
)
|
|
42
|
+
return 1
|
|
43
|
+
found = _version(node)
|
|
44
|
+
if found is None or found < MIN_NODE:
|
|
45
|
+
have = "unknown" if found is None else "%d.%d" % found
|
|
46
|
+
print("xtruct needs Node.js 18.3 or newer (found %s at %s)." % (have, node), file=sys.stderr)
|
|
47
|
+
return 1
|
|
48
|
+
|
|
49
|
+
args = [node, str(CLI)] + sys.argv[1:]
|
|
50
|
+
if os.name == "posix":
|
|
51
|
+
os.execv(node, args) # hand the terminal and signals straight to node
|
|
52
|
+
return subprocess.call(args)
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
if __name__ == "__main__":
|
|
56
|
+
sys.exit(main())
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: xtruct
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: A software company made of Claude Code agents: architect, leads, developers, reviewers and QA, with ClickUp as the board and gated PR merges.
|
|
5
|
+
Project-URL: Homepage, https://xtruct.masst.dev
|
|
6
|
+
Author: Aditya Narayan
|
|
7
|
+
License-Expression: MIT
|
|
8
|
+
License-File: LICENSE
|
|
9
|
+
Keywords: ai-agents,claude-code,clickup,code-review,multi-agent,scaffold
|
|
10
|
+
Classifier: Development Status :: 3 - Alpha
|
|
11
|
+
Classifier: Environment :: Console
|
|
12
|
+
Classifier: Intended Audience :: Developers
|
|
13
|
+
Classifier: Operating System :: MacOS
|
|
14
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Topic :: Software Development :: Code Generators
|
|
17
|
+
Requires-Python: >=3.9
|
|
18
|
+
Description-Content-Type: text/markdown
|
|
19
|
+
|
|
20
|
+
# Xtruct
|
|
21
|
+
|
|
22
|
+
A software company made of [Claude Code](https://claude.com/claude-code) agents. You are the founder: you approve the spec and sign off on working software. An architect plans and draws the product, leads split it into ClickUp tasks, developer agents build each one in its own git worktree, and reviewers, CI and a merge gate land every change on main.
|
|
23
|
+
|
|
24
|
+
This is the Python distribution of the same CLI published to npm as `@masst/xtruct`. Use whichever fits your stack; both behave identically.
|
|
25
|
+
|
|
26
|
+
## Install
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
uv tool install xtruct # or: pipx install xtruct, or: pip install xtruct
|
|
30
|
+
xtruct new my-app
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
One-off, without installing: `uvx xtruct new my-app`. Use an installed copy (not `uvx`) for `xtruct setup`, because setup wires your Claude Code hooks to the installed files.
|
|
34
|
+
|
|
35
|
+
## Requirements
|
|
36
|
+
|
|
37
|
+
- Node.js 18.3+ on your PATH (the CLI runs on Node; set `XTRUCT_NODE` to point at a specific binary)
|
|
38
|
+
- Claude Code with workflows, and the ClickUp connector enabled
|
|
39
|
+
- `git`, `gh` (logged in), `jq`, `make`
|
|
40
|
+
|
|
41
|
+
Run `xtruct doctor` to check everything. Full docs: https://xtruct.masst.dev
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
xtruct/__init__.py,sha256=jcEWxIE_BpV5Vh36_d17D3GB1lsKcizPWLdcC30OoAs,84
|
|
2
|
+
xtruct/__main__.py,sha256=ZgiPRMfDrYvcl8rf-x93u9NfPRtc_dFyX9DBtjgXMao,57
|
|
3
|
+
xtruct/launcher.py,sha256=R7GamixflIZHBZeA2HBf3PEBN1UcxuVWUaN5TB21GAo,1728
|
|
4
|
+
xtruct/_cli/package.json,sha256=tn62F0m0jP9BftMQ8G9Eew8OQFhy-iQsQvw6aKqvR9w,1001
|
|
5
|
+
xtruct/_cli/bin/xtruct-foundry.js,sha256=21A39ssxwdoIrIpTA6g4BceUlj03OaY6yRM0uXZYEkI,147
|
|
6
|
+
xtruct/_cli/bin/xtruct.js,sha256=9MVfer1uNKZrrpWVRD1wvSio8psYbn3hcio0s0zrdkk,24274
|
|
7
|
+
xtruct/_cli/global/claude-md-block.md,sha256=oh0VlsZmvjPt8pFc2zG8xh-7MzeXSCm6IiGAzcA5QfI,664
|
|
8
|
+
xtruct/_cli/global/skills/foundry/SKILL.md,sha256=65GYfwtNMeiYEGIU34h_bKXl2DELKfusJ3HdJpva60c,3020
|
|
9
|
+
xtruct/_cli/lib/dashboard.html,sha256=ZDPjYUbBrg_TAFqn1absqPNWH5eRy8Av_rQchmrUAuo,21958
|
|
10
|
+
xtruct/_cli/lib/dashboard.js,sha256=9oPLKz4ldmyiRqNNotdmfjFcOHp3gukY_UkGUpPGhHc,11081
|
|
11
|
+
xtruct/_cli/lib/paths.js,sha256=l5QiAszyLnyJ263co_YC3PB2R0fIheMmDeGGZorRQ2U,595
|
|
12
|
+
xtruct/_cli/lib/setup.js,sha256=Y_H-utQGYFRulBO_-uJmQBJnOLGN9S2xySL4u3HIC9k,6743
|
|
13
|
+
xtruct/_cli/lib/tracker.js,sha256=Y81Ovz9sgLwB_g__-0q6CXIivLZ4CmLUGZijNl_zUKM,6436
|
|
14
|
+
xtruct/_cli/lib/ui.js,sha256=URw190mpTuS4L6DYNg0-5VBgzSS7Q_ePtgQ1ChFYnFM,4069
|
|
15
|
+
xtruct/_cli/template/CLAUDE.md,sha256=UPUu8Za_K7pEw8F-tdeFwZrPGh8tiuxJyHixxol_tm0,4137
|
|
16
|
+
xtruct/_cli/template/Makefile,sha256=5Z5EXoaPrgXJ5BxK7EogOndDME-Qbbpe0Vx3UxTBfU4,395
|
|
17
|
+
xtruct/_cli/template/_gitignore,sha256=wfr0F79SSN6wbo6TegOjBCBxo2xNnbR9b1lz5FZ41lg,154
|
|
18
|
+
xtruct/_cli/template/foundry.config.json,sha256=lZSK7fxlrbojQwYwpYhiNFet7axCsgDD2_NyMHUQCqo,432
|
|
19
|
+
xtruct/_cli/template/.claude/settings.json,sha256=6GedIkcE3f27U2UxGV4yIAqz6zXknlTNKDVMVKueL3Q,925
|
|
20
|
+
xtruct/_cli/template/.claude/agents/architect.md,sha256=gk8-pF4H0dX2L1Gem7SBow3WG1UP5vZDD4WWP2ZqOFk,3309
|
|
21
|
+
xtruct/_cli/template/.claude/agents/integrator.md,sha256=BxddoF9cbhZygytc6Sc7fbL4_cT538YAsaPuiYTGFFU,1342
|
|
22
|
+
xtruct/_cli/template/.claude/agents/junior-dev.md,sha256=KOT-uXSdJ1hlbv4gXA08QV9hVtTd9MHfkRE6VULDw8U,2264
|
|
23
|
+
xtruct/_cli/template/.claude/agents/qa-lead.md,sha256=TWC5OAoq_OKKU5uGDYAeQrOMltu1EfpP6cDcPZnL6R4,1290
|
|
24
|
+
xtruct/_cli/template/.claude/agents/reviewer.md,sha256=kFeMzq3HLE008vIxFLmlzk9HO8d5GoliOyIFIAm1Z8c,1721
|
|
25
|
+
xtruct/_cli/template/.claude/agents/senior-lead.md,sha256=3ok1iy1pcfTc_JxsiWRNRr_SllvVblL3frX8sGUWQPw,2797
|
|
26
|
+
xtruct/_cli/template/.claude/hooks/guard-bash.sh,sha256=1FI6yQ9F7U0VYmgujlJo3z-0UJ55l9aV6LZwKA7eI4k,2130
|
|
27
|
+
xtruct/_cli/template/.claude/hooks/guard-files.sh,sha256=TOGwSdGlD7WzDL615EhnnSVyqvdpmr9ZP3GL4tBEM50,986
|
|
28
|
+
xtruct/_cli/template/.claude/skills/run-epics/SKILL.md,sha256=h_SjQewnEmS-xN6YbqFj9-AVUsKEd5O9Flk0xTOYrNw,2692
|
|
29
|
+
xtruct/_cli/template/.claude/workflows/plan-product.js,sha256=M6-R_i9HF6Mguzsk2KYaZNg08BMwLaS7em6L5evL0Fs,6642
|
|
30
|
+
xtruct/_cli/template/.claude/workflows/run-epic.js,sha256=Z8wmbfiUBtBSopkEMaFDrcrg_S73_aGPvACWzWcspJU,10105
|
|
31
|
+
xtruct/_cli/template/.github/pull_request_template.md,sha256=gOSAnPtgikWdcpGpYBfAc4YHjIIjr5Ct-oRJxDZXq0w,331
|
|
32
|
+
xtruct/_cli/template/contracts/README.md,sha256=X9crV3mGrEm2yBqWcTpWU-g2J5W251Pq01yvJWeEDUI,184
|
|
33
|
+
xtruct/_cli/template/docs/CONVENTIONS.md,sha256=2iXTEhBeazaJjIRLr_lgYXRndEgqQl6LsaMCdy6S16o,107
|
|
34
|
+
xtruct/_cli/template/docs/templates/ARCHITECTURE.md,sha256=rPQL8YCibcJE5qS13D-DmeykNTwJc0_2w0n7mypwbdA,604
|
|
35
|
+
xtruct/_cli/template/docs/templates/PRD.md,sha256=QK1vRus_3bnFMhoZ798LBlkRKSNoI8v6qnK-v5qWP4w,565
|
|
36
|
+
xtruct/_cli/template/docs/templates/ci.yml,sha256=lpUM9_jdlYEsNmXUePayCYeHKP1S6gLeI99eaF01FKk,662
|
|
37
|
+
xtruct/_cli/template/scripts/bootstrap-github.sh,sha256=zkfYYJMORAJ8AvPhyWS_YzkOD2tfVP8JPD-5ak6gT9o,2105
|
|
38
|
+
xtruct/_cli/template/scripts/capacity.mjs,sha256=80k6zMjFbE59IqjQ4b2oMBB2EIwWyysfuL1czXnernc,2424
|
|
39
|
+
xtruct/_cli/template/scripts/merge-pr.sh,sha256=iHrMVzL8RVO3uXFQzqgrwLkWqlJFslj2QDmao1PfwGw,4292
|
|
40
|
+
xtruct-0.1.0.dist-info/METADATA,sha256=6LB6PiycgRv2BMCWwzmevnVBxyMB36AoR8BMzbBRV6k,1875
|
|
41
|
+
xtruct-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
|
|
42
|
+
xtruct-0.1.0.dist-info/entry_points.txt,sha256=vED-hooqW1HgsCn6uVXVfkma7e-dV_9WaNsQlZmWwfE,48
|
|
43
|
+
xtruct-0.1.0.dist-info/licenses/LICENSE,sha256=QMrgSurImi5bHv5TMI5phv0CVR4EpBDZo2ExlH6tETM,1071
|
|
44
|
+
xtruct-0.1.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Aditya Narayan
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|