### Development Setup and Commands

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Instructions for cloning the repository, installing dependencies, and running development tasks. The `pnpm dev` command starts the dashboard and requires a .truecourse/ folder.

```bash
git clone https://github.com/truecourse-ai/truecourse.git
cd truecourse
pnpm install
pnpm dev                # Start dashboard at http://localhost:3000 (server on :3001, Vite on :3000)
pnpm test               # Run tests
pnpm build              # Build all packages
```

--------------------------------

### CLI First Run Setup

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

This command initiates the Truecourse CLI. On the first run, it launches an interactive setup wizard to configure LLM providers, API keys, and start the embedded PostgreSQL database.

```bash
npx truecourse        # first run: setup wizard → start
```

--------------------------------

### Clone Repository and Install Dependencies

Source: https://github.com/truecourse-ai/truecourse/blob/main/CONTRIBUTING.md

Clone the TrueCourse repository, navigate into the directory, install dependencies using pnpm, and start the development server.

```bash
git clone https://github.com/truecourse-ai/truecourse.git
cd truecourse
pnpm install
pnpm dev          # Start all services (Vite frontend + Express backend)
```

--------------------------------

### Setup Integration: Prompt for Claude Code Plugin Installation

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

This code snippet shows the prompt presented to the user during the `truecourse setup` process when selecting 'Claude Code CLI' as the LLM provider, asking whether to install the TrueCourse Claude Code plugin.

```typescript
? Would you like to install the TrueCourse Claude Code plugin?
  ● Yes (Recommended)
  ○ No
```

--------------------------------

### TrueCourse Setup Prompt for LLM Provider Selection

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Illustrates the interactive prompt presented by `truecourse setup` for selecting an LLM provider. Options include Anthropic (Claude API), OpenAI (GPT API), Claude Code CLI, and skipping setup.

```bash
? Which LLM provider would you like to use?
  ○ Anthropic (Claude API)
  ○ OpenAI (GPT API)
  ○ Claude Code CLI (no API key needed)
  ○ Skip for now
```

--------------------------------

### CLI Subsequent Runs

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Subsequent runs of the Truecourse CLI will bypass the setup wizard and directly start the server and open the browser.

```bash
npx truecourse        # subsequent runs: just start
```

--------------------------------

### CLI Commands

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Provides an overview of available commands for the Truecourse CLI, including the default behavior, re-running setup, and starting the server.

```bash
truecourse        # default: run setup if first time, otherwise start
```

```bash
truecourse setup  # re-run setup wizard
```

```bash
truecourse start  # skip setup, just start
```

--------------------------------

### Start Server Without Opening Browser

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Use this command to start the TrueCourse server without automatically opening a browser. A hint will be printed to guide the user on how to open the dashboard manually.

```bash
truecourse start
```

--------------------------------

### Connected Local Mode Setup Flow

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Outlines the command-line setup process for enabling connected local mode, including selecting the mode, providing a connection key, and storing configuration.

```text
truecourse setup
  → "Connected to cloud" selected
  → Paste connection key
  → Key validated against cloud API
  → Stored in .env: TRUECOURSE_CLOUD_KEY, TRUECOURSE_CLOUD_URL
  → Local server starts in connected mode (no DB, no LLM config needed)
```

--------------------------------

### Start and Manage TrueCourse Dashboard

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Commands to start, reconfigure, stop, check status, view logs, and uninstall the TrueCourse dashboard.

```bash
truecourse dashboard                  # Start + open the dashboard
truecourse dashboard --reconfigure    # Re-prompt for console vs background service mode
truecourse dashboard stop             # Stop the dashboard
truecourse dashboard status           # Show dashboard status
truecourse dashboard logs             # Tail dashboard logs (service mode only)
truecourse dashboard uninstall        # Remove the background service
```

--------------------------------

### Example .truecourseignore file

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/drift-fp-automation/prompts/drift-fp-generate.md

This example shows how to configure the .truecourseignore file to scope the spec corpus for the 'spec scan' command. It ignores all markdown files by default and then re-includes specific directories.

```shell
*.md
!docs/docs/docs/01-core/authentication/**
!docs/docs/docs/01-core/content-manager/**
!docs/docs/docs/01-core/content-releases/**
!docs/docs/docs/01-core/permissions/**
!docs/docs/rfcs/**
```

--------------------------------

### Get TrueCourse Version

Source: https://github.com/truecourse-ai/truecourse/blob/main/CONTRIBUTING.md

Command to retrieve the currently installed TrueCourse version, useful for bug reporting.

```bash
npx truecourse --version
```

--------------------------------

### Install TrueCourse Pre-commit Hook

Source: https://github.com/truecourse-ai/truecourse/blob/main/tools/cli/skills/truecourse/truecourse-hooks/SKILL.md

Installs the TrueCourse pre-commit hook. Ensure you use `npx -y` to avoid prompts. This command creates `.git/hooks/pre-commit` and `.truecourse/hooks.yaml`.

```bash
npx -y truecourse hooks install
```

--------------------------------

### Linter Configuration Import Report Example

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

An example migration report detailing the outcome of importing an ESLint configuration into TrueCourse. It shows matched rules, uncovered rules requiring custom implementation, and additional TrueCourse features.

```text
Imported ESLint config (.eslintrc.json):

 Matched (TrueCourse will use your settings):
   no-console → off (disabled)
   no-explicit-any → warn
   no-self-compare → error
   ... 47 more

 Not covered (need custom rules):
   @typescript-eslint/naming-convention → warn
   my-plugin/custom-rule → error
   ... 3 more

 TrueCourse extras (not in your ESLint):
   architecture/deterministic/circular-service-dependency
   architecture/deterministic/god-service
   code-quality/deterministic/cognitive-complexity
   ... 20 more

You can safely remove ESLint.
```

--------------------------------

### TrueCourse Setup Prompt

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

This snippet shows the interactive prompt for setting up TrueCourse, allowing users to choose between standalone or connected modes.

```bash
truecourse setup

? How would you like to use TrueCourse?
  ○ Standalone (local only, bring your own API key)
  ○ Connected to cloud (uses your team's cloud workspace)
```

--------------------------------

### Database Schema for GitHub Installations

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Defines the schema for the 'github_installations' table, tracking GitHub App installations linked to workspaces.

```sql
github_installations
  id, workspace_id (FK), github_installation_id (unique),
  github_account_login, github_account_type (org/user),
  installed_by (FK → users), created_at, removed_at
```

--------------------------------

### Manage Pre-commit Hook

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Command to install, configure, or remove the pre-commit hook for TrueCourse.

```bash
/truecourse-hooks
```

--------------------------------

### Install Claude Code Skills

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Command to install Claude Code skills into a repository. The prompt is skipped if skills are already present. Use flags to bypass the prompt explicitly.

```bash
truecourse analyze
truecourse add
```

--------------------------------

### Development Commands

Source: https://github.com/truecourse-ai/truecourse/blob/main/AGENTS.md

Common commands for developing the TrueCourse project using pnpm. These include starting services, building packages, and running tests.

```bash
pnpm dev          # Start all services (turbo) — file-based store under <repo>/.truecourse/
pnpm build        # Build all packages
pnpm build:dist   # Build distributable npm package (static frontend + bundled server → dist/)
pnpm test         # Run all tests (vitest)
```

--------------------------------

### Architecture Guidelines Table Example

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

A sample table displaying extracted architecture rules, their severity, description, and type (Code or LLM). This is part of the user review process.

```text
Extracted 12 rules from "architecture-guidelines.md":

 ┌────┬──────────┬──────────────────────────────────────────┬───────────┐
 │  # │ Severity │ Rule                                     │ Type      │
 ├────┼──────────┼──────────────────────────────────────────┼───────────┤
 │  1 │ HIGH     │ No direct DB access from controllers     │ Code      │
 │  2 │ HIGH     │ All services must have error boundaries  │ LLM       │
 │  3 │ HIGH     │ Max 8 files per service                  │ Code      │
 │  4 │ MEDIUM   │ Use repository pattern for data access   │ LLM       │
 │  5 │ MEDIUM   │ Events preferred over sync HTTP calls    │ LLM       │
 │  6 │ LOW      │ Service names must match directory names  │ Code      │
 │ .. │ ...      │ ...                                      │ ...       │
 └────┴──────────┴──────────────────────────────────────────┴───────────┘

 Accept all? Or review individually? [accept/review/edit/skip]
```

--------------------------------

### Rule Category Selection Prompt

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

During the 'truecourse setup' process, users are presented with a prompt to select which rule categories they want to enable. All categories are enabled by default.

```bash
? Which rule categories would you like to enable?
  ◉ Architecture rules (circular deps, god services, layer violations)
  ◉ Code rules (code quality, security, complexity)
  ◉ Database rules (schema issues, missing indexes, naming)
```

--------------------------------

### Service Dependency Graph Visualization

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

An example of an ASCII visualization representing service dependencies. This format is rendered by Claude based on data from the MCP server.

```ascii
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  API Gateway │────▶│ UserService  │────▶│ AuthService  │
└──────┬───────┘     └──────┬───────┘     └──────────────┘
       │                    │
       ▼                    ▼
┌──────────────┐     ┌──────────────┐
│ OrderService │────▶│  [Postgres]  │
└──────┬───────┘     └──────────────┘
       │
       ▼
┌──────────────┐
│   [Redis]    │
└──────────────┘
```

--------------------------------

### Create a Feature Branch

Source: https://github.com/truecourse-ai/truecourse/blob/main/CONTRIBUTING.md

Example of creating a new Git branch for a feature, following the recommended naming convention.

```bash
git checkout -b feat/my-feature
```

--------------------------------

### Bumping Package Version

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/fp-automation/README.md

This example demonstrates updating the version number in multiple package.json files and a TypeScript index file. This is a required step for releasing new versions.

```json
"version": "X.Y.Z"
```

```typescript
.version("X.Y.Z")
```

--------------------------------

### Start Background LLM Stage

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/drift-fp-automation/prompts/drift-fp-generate.md

Initiates an LLM stage in the background using the agent transport. The process is managed via a specified IO directory for requests and responses.

```bash
mkdir -p /tmp/llm-io/requests /tmp/llm-io/responses
cd /tmp/target && node $TRUECOURSE_DIR/dist/cli.mjs spec scan --llm-transport agent --io /tmp/llm-io &
```

--------------------------------

### GitHub PR Comment Markdown Example

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Example of a Markdown comment posted to a GitHub Pull Request summarizing analysis violations.

```markdown
## TrueCourse Analysis

| Severity | Count |
|----------|-------|
| Critical | 2 |
| High | 3 |
| Medium | 5 |
| Low | 7 |

🔗 [View full analysis →](https://app.truecourse.dev/w/acme/repo/api/analysis/123)
```

--------------------------------

### Running Truecourse CLI for Analysis

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/fp-automation/README.md

This command installs and builds Truecourse, then runs the analyze command on a target repository. It uses deterministic rules and operates on the current working directory, writing results to .truecourse/LATEST.json.

```bash
pnpm install && pnpm build:dist
cd /tmp/target && node $TRUECOURSE_DIR/dist/cli.mjs analyze --no-llm --no-stash --no-skills
```

--------------------------------

### Common Development Commands

Source: https://github.com/truecourse-ai/truecourse/blob/main/CONTRIBUTING.md

A list of essential pnpm commands for developing TrueCourse, including starting the dev server, building packages, running tests, and building distributable packages.

```bash
pnpm dev          # Start all services
pnpm build        # Build all packages
pnpm test         # Run all tests (vitest)
pnpm build:dist   # Build distributable npm package (static frontend + bundled server → dist/)
```

--------------------------------

### Negative Claim Example (Out of Scope)

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/contracts/PLAN.md

Example of defining 'out-of-scope' items within a module configuration. This specifies operations or features that are explicitly excluded from the current scope.

```yaml
# modules/infractions/module.yaml
out-of-scope:
  - id: missing-existing-motor-sn-photo
    reason: "SQL not yet written"
    source: "docs/PRDs/backend_PRDv2.md:142"
  - id: no-review-link-sent
    reason: "no send-event data"
    source: "docs/PRDs/backend_PRDv2.md:143"
```

--------------------------------

### Importing Rules from Local Documents

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Use this command to import architecture guidelines from a local markdown file into TrueCourse.

```bash
$ truecourse rules import ./docs/architecture-guidelines.md
```

--------------------------------

### CLI JSONL Output Example

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Demonstrates using the --jsonl flag with 'truecourse list' to output violations as JSON objects per line, enabling filtering with tools like jq.

```bash
truecourse list --jsonl | jq 'select(.severity == "critical")'
```

```bash
truecourse list --jsonl | grep '"ruleKey":"arch/circular"' | wc -l
```

--------------------------------

### Install TrueCourse Git Hooks

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Installs the TrueCourse pre-commit hook to analyze staged files before allowing a commit. This helps prevent common code quality issues from being committed.

```bash
truecourse hooks install
```

--------------------------------

### GitHub Webhook Receiver

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Receives webhook events from GitHub, verifies signatures, and processes pull request or installation events to enqueue analysis jobs or manage installation records.

```APIDOC
## POST /api/webhooks/github

### Description
Receives and processes webhook events from GitHub. It verifies the webhook signature, and based on the event type (pull_request or installation), it either enqueues an analysis job for repository members or updates the GitHub installation records.

### Method
POST

### Endpoint
/api/webhooks/github

### Parameters
#### Request Body
This endpoint expects a JSON payload containing GitHub webhook event data. The specific fields depend on the event type (e.g., `pull_request` or `installation`).

### Request Example
(Example depends on the specific GitHub event payload)

### Response
#### Success Response (200 OK)
Indicates that the webhook was received and processed successfully. The actual response body may vary.

#### Error Response
- **400 Bad Request**: If the webhook signature is invalid or the payload is malformed.
- **500 Internal Server Error**: If an unexpected error occurs during processing.
```

--------------------------------

### Verification Steps for Rule Integration

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

A sequence of steps demonstrating the workflow from importing guidelines to running analysis and observing violations, including UI and CLI interactions.

```bash
1. truecourse rules import ./guidelines.md → LLM extracts rules with generated checker code → review prompt shown
2. Review a code-type rule → see the generated checker function → accept it
3. Accept rules → they appear in the Rules tab with "Company" badge
4. Run analysis → code-type rules execute in sandbox, produce violations referencing company guidelines
5. Run analysis → LLM-type rules produce violations via LLM prompt guidance
6. Import via URL → content fetched and processed the same way
7. Import via "--text ..." → single rule extracted
8. Web UI: upload file via Rules tab → same extraction flow, code review in browser
9. Edit a custom rule's checker code in the UI → next analysis uses updated code
10. A checker that throws or times out → warning logged, analysis continues without that rule
11. Delete a guideline source → its rules are removed
12. truecourse rules generate on a real project → LLM suggests rules based on codebase patterns → review prompt shown
13. Accept generated rules → they run during next analysis and catch deviations from established patterns
14. truecourse rules reprocess → re-extracts and regenerates checker code from stored sources
15. pnpm build and pnpm test pass
```

--------------------------------

### GET /api/customers/:id

Source: https://github.com/truecourse-ai/truecourse/blob/main/tests/fixtures/sample-js-project-il/reference/specs/modules/customers/endpoints.md

Fetches a single customer by their unique identifier.

```APIDOC
## GET /api/customers/:id

### Description
Fetches a single customer by their unique identifier.

### Method
GET

### Endpoint
/api/customers/:id

### Parameters
#### Path Parameters
- **id** (string) - Required - The UUID of the customer to fetch. Must be a valid UUID.

### Response
#### Success Response (200)
- The `Customer` object.

#### Error Response (400)
- Standard error envelope with code `validation_failed` if the `id` is not a valid UUID.

#### Error Response (404)
- Standard error envelope with code `customer_not_found` if the customer with the specified ID is not found.
```

--------------------------------

### Initialize TrueCourse Baseline

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

After the first analysis, commit the generated TrueCourse baseline files to your repository. This establishes a reference point for future analyses.

```bash
truecourse analyze
git add .truecourse/LATEST.json .truecourse/config.json
git commit -m "add truecourse baseline"
```

--------------------------------

### Disable a Rule Category

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Disables a specific rule category, for example, 'style'.

```bash
truecourse rules categories --disable style
```

--------------------------------

### Enable a Rule Category

Source: https://github.com/truecourse-ai/truecourse/blob/main/README.md

Enables a specific rule category, for example, 'style'.

```bash
truecourse rules categories --enable style
```

--------------------------------

### Get Violation Breakdown

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Fetches the current distribution of violations by type and severity.

```APIDOC
## GET /api/repos/:id/analytics/breakdown

### Description
Retrieves the current breakdown of violations by type (e.g., architecture, module, code, security) and severity (critical, high, medium, low).

### Method
GET

### Endpoint
/api/repos/:id/analytics/breakdown

### Parameters
#### Path Parameters
- **id** (string) - Required - The repository ID.

### Response
#### Success Response (200)
- **typeBreakdown** (object) - Distribution of violations by type.
  - **architecture** (integer) - Count of architecture violations.
  - **module** (integer) - Count of module violations.
  - **code** (integer) - Count of code violations.
  - **security** (integer) - Count of security violations.
- **severityDistribution** (object) - Distribution of violations by severity.
  - **critical** (integer) - Count of critical severity violations.
  - **high** (integer) - Count of high severity violations.
  - **medium** (integer) - Count of medium severity violations.
  - **low** (integer) - Count of low severity violations.
```

--------------------------------

### Build Truecourse CLI from Local Source

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/drift-fp-automation/prompts/drift-fp-discover.md

Installs dependencies and builds the Truecourse CLI artifact from the local source code. This ensures the use of the exact same artifact that is published, avoiding discrepancies.

```shell
pnpm install && pnpm build:dist
```

--------------------------------

### Run TrueCourse Analysis with LLM Rules

Source: https://github.com/truecourse-ai/truecourse/blob/main/tools/cli/skills/truecourse/truecourse-analyze/SKILL.md

Execute TrueCourse analysis including LLM-powered rules for higher-value insights. Ensure user approval for token costs before running.

```bash
npx -y truecourse analyze --llm
```

--------------------------------

### Get Workspace Details and Members

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Retrieves the details of a specific workspace, including its members.

```APIDOC
## GET /api/workspaces/:id

### Description
Retrieves the details of a specific workspace, including its members.

### Method
GET

### Endpoint
/api/workspaces/:id
```

--------------------------------

### Importing Rules from Free Text

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Add a single, simple rule directly from the command line using free text input.

```bash
$ truecourse rules import --text "Services must not call the database directly, always go through a repository layer"
```

--------------------------------

### Get Top Offenders

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Retrieves a ranked list of services or modules with the most active violations.

```APIDOC
## GET /api/repos/:id/analytics/top-offenders

### Description
Retrieves a list of services or modules ranked by their count of active violations.

### Method
GET

### Endpoint
/api/repos/:id/analytics/top-offenders

### Parameters
#### Path Parameters
- **id** (string) - Required - The repository ID.

### Response
#### Success Response (200)
- **offenders** (array) - A list of objects, each representing an offender.
  - **serviceName** (string) - The name of the service or module.
  - **activeViolations** (integer) - The count of active violations in this service/module.
```

--------------------------------

### Analyze Code (Full Mode)

Source: https://github.com/truecourse-ai/truecourse/blob/main/tools/cli/skills/truecourse/truecourse-fix/SKILL.md

Run a full analysis of the repository. This command prompts the user to decide whether to include LLM-based rules.

```bash
/truecourse-analyze
```

--------------------------------

### Initiate Fix for Violations

Source: https://github.com/truecourse-ai/truecourse/blob/main/tools/cli/skills/truecourse/truecourse-list/SKILL.md

Use to start the fixing process for violations that have an attached 'Fix:' block.

```bash
/truecourse-fix
```

--------------------------------

### Get Current User and Workspaces

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Retrieves information about the currently authenticated user and the workspaces they belong to.

```APIDOC
## GET /api/auth/me

### Description
Retrieves information about the currently authenticated user and the workspaces they belong to.

### Method
GET

### Endpoint
/api/auth/me
```

--------------------------------

### Auth Module Configuration

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/contracts/PLAN.md

Example configuration for an 'auth' module, specifying its name, status, description, source documentation, and scope. This is used for detecting logical modules from specification content.

```yaml
# .truecourse/spec/modules/auth/module.yaml
name: auth
status: active
description: Wallet-based authentication and session management.
source-docs:
  - docs/API.md#authentication
  - docs/auth/wallet-flow.md
scope:
  paths:
    - /api/auth/**
  tags:
    - auth
last-reviewed: 2026-05-09
```

--------------------------------

### Get Order by ID

Source: https://github.com/truecourse-ai/truecourse/blob/main/tests/fixtures/sample-js-project-il/reference/specs/modules/orders/data.md

Retrieves a specific order by its ID. Non-admin users can only access orders they own.

```APIDOC
## GET /api/orders/:id

### Description
Retrieves a specific order by its ID. Non-admin callers may only read orders they own.

### Method
GET

### Endpoint
/api/orders/:id

### Parameters
#### Path Parameters
- **id** (UUID) - Required - The unique identifier of the order.

### Response
#### Success Response (200)
- **id** (UUID) - server-assigned, immutable
- **status** (OrderStatus) - see lifecycle
- **subtotalCents** (integer) - >= 0; client-supplied; immutable after creation
- **discountCents** (integer) - server-computed; immutable after creation
- **taxCents** (integer) - server-computed; immutable after creation
- **totalCents** (integer) - server-computed; immutable after creation
- **customerId** (UUID) - references an existing Customer; immutable
- **placedAt** (ISO 8601) - server-assigned at creation; immutable
- **updatedAt** (ISO 8601) - server-assigned; refreshed on every mutation

#### Error Response
- **403** - with code `forbidden` if ownership rules are violated.
```

--------------------------------

### Regenerate Specs

Source: https://github.com/truecourse-ai/truecourse/blob/main/tests/fixtures/sample-js-project-il/reference/SKILL_REGEN_AND_EVAL.md

Navigates into the fixture directory and runs commands to scan, resolve defaults, and apply generated specs. This process materializes the output in `.truecourse/specs/`.

```bash
cd tests/fixtures/sample-js-project-il
truecourse spec scan
truecourse spec resolve --all-defaults
truecourse spec apply
cd -
```

--------------------------------

### Check TrueCourse Git Hook Status

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Displays the current status of the installed TrueCourse git hooks.

```bash
truecourse hooks status
```

--------------------------------

### Import Linter Configuration CLI Commands

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Command-line interface commands for importing linter configurations into TrueCourse. These commands help in automatically detecting or specifying the linter to import from.

```bash
truecourse linter import              # Auto-detect linter config in current project
```

```bash
truecourse linter import --from eslint
```

```bash
truecourse linter import --from ruff
```

--------------------------------

### Uninstall TrueCourse Git Hooks

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/PLAN.md

Removes the installed TrueCourse pre-commit hook from the git hooks directory.

```bash
truecourse hooks uninstall
```

--------------------------------

### fp-discover Routine Bootstrap Prompt

Source: https://github.com/truecourse-ai/truecourse/blob/main/docs/fp-automation/README.md

The specific bootstrap prompt for the 'fp-discover' routine, instructing it to execute prompts from 'fp-discover.md'.

```text
> Execute the instructions in `docs/fp-automation/prompts/fp-discover.md` from the cloned `truecourse-ai/truecourse` repository. Treat that file as the authoritative prompt; follow every step exactly. If the file is missing or unreadable, post a short failure note in the session and end.
```

--------------------------------

### GET /api/customers

Source: https://github.com/truecourse-ai/truecourse/blob/main/tests/fixtures/sample-js-project-il/docs/PRDs/orders_PRDv2.md

Retrieves a paginated list of customers. This endpoint uses the same pagination contract as the Orders API.

```APIDOC
## GET /api/customers

### Description
Retrieves a paginated list of customers. This endpoint uses the same pagination contract as the Orders API.

### Method
GET

### Endpoint
/api/customers

### Parameters
#### Query Parameters
- **cursor** (string) - Optional - The cursor for pagination.
- **limit** (integer) - Optional - The maximum number of items to return.
```

--------------------------------

### GET /api/orders/:id

Source: https://github.com/truecourse-ai/truecourse/blob/main/tests/fixtures/sample-js-project-il/docs/PRDs/orders_PRDv2.md

Fetches a specific order by its ID. Returns a 404 error if the order is not found.

```APIDOC
## GET /api/orders/:id

### Description
Fetches a specific order by its ID. Returns a 404 error if the order is not found.

### Method
GET

### Endpoint
/api/orders/:id

### Parameters
#### Path Parameters
- **id** (UUID) - Required - The ID of the order to fetch.

### Response
#### Success Response (200)
- **Order** (object) - The requested order object.

### Errors
- **400** - If the `id` is not a valid UUID.
- **404** - `order_not_found` if the order does not exist.
```