llm-api-scope 0.2.1__tar.gz → 0.3.1__tar.gz

{llm_api_scope-0.2.1/llm_api_scope.egg-info → llm_api_scope-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llm-api-scope
-Version: 0.2.1
+Version: 0.3.1
 Summary: Command-line tool for LLMs to quickly search and understand OpenAPI endpoints
 Author-email: D7x7z49 <85430783+D7x7z49@users.noreply.github.com>
 License: MIT License
@@ -71,3 +71,16 @@ Search within a specific API specification (`<name>`) for endpoints matching the
 
 ### `apiscope describe <name> <path:method> [--force]`
 Generate and output a concise Markdown guide for using the specified endpoint (`<path:method>`) from the API specification (`<name>`). The guide includes essential calling information such as parameters, request body, and response structure.
+
+### `apiscope note`
+Manage reflective notes for agent reasoning and knowledge capture. This command provides a structured notebook system with six cognitive note types: Observation (OBS), Reasoning (REA), Action (ACT), Reflection (REF), Question (QUE), and Inspiration (INS).
+
+Available subcommands:
+- `auth`: Establish and manage agent identity authentication through three philosophical dimensions (Name, Role, Story). Required before creating notes to ensure the agent has a defined sense of self.
+- `write`: Create a new note with specified author and type (uses two-phase write mechanism)
+- `read`: Display notes for a specific author with pagination and size limits
+- `add`: Append annotations (REFERENCE, NOTE, or TIP) to existing notes
+- `stats`: Analyze note-taking patterns, temporal concentration, and thinking segments
+- `readme`: Display comprehensive documentation about the note system
+
+Notes are stored in `.apiscope/notes/` with automatic organization by author and timestamp. The system supports pattern recognition for classical thinking sequences like Empirical Induction, Hypothetico-Deductive reasoning, and Experimental Science. For complete documentation, run `apiscope note readme`.

{llm_api_scope-0.2.1 → llm_api_scope-0.3.1}/README.md

@@ -24,3 +24,16 @@ Search within a specific API specification (`<name>`) for endpoints matching the
 
 ### `apiscope describe <name> <path:method> [--force]`
 Generate and output a concise Markdown guide for using the specified endpoint (`<path:method>`) from the API specification (`<name>`). The guide includes essential calling information such as parameters, request body, and response structure.
+
+### `apiscope note`
+Manage reflective notes for agent reasoning and knowledge capture. This command provides a structured notebook system with six cognitive note types: Observation (OBS), Reasoning (REA), Action (ACT), Reflection (REF), Question (QUE), and Inspiration (INS).
+
+Available subcommands:
+- `auth`: Establish and manage agent identity authentication through three philosophical dimensions (Name, Role, Story). Required before creating notes to ensure the agent has a defined sense of self.
+- `write`: Create a new note with specified author and type (uses two-phase write mechanism)
+- `read`: Display notes for a specific author with pagination and size limits
+- `add`: Append annotations (REFERENCE, NOTE, or TIP) to existing notes
+- `stats`: Analyze note-taking patterns, temporal concentration, and thinking segments
+- `readme`: Display comprehensive documentation about the note system
+
+Notes are stored in `.apiscope/notes/` with automatic organization by author and timestamp. The system supports pattern recognition for classical thinking sequences like Empirical Induction, Hypothetico-Deductive reasoning, and Experimental Science. For complete documentation, run `apiscope note readme`.

{llm_api_scope-0.2.1 → llm_api_scope-0.3.1}/apiscope/cli.py

@@ -6,6 +6,7 @@ from .commands.init import init_command
 from .commands.list import list_command
 from .commands.search import search_command
 from .commands.describe import describe_command
+from .commands.note import note_command
 
 
 @click.group()
@@ -30,6 +31,7 @@ cli.add_command(init_command, name="init")
 cli.add_command(list_command, name="list")
 cli.add_command(search_command, name="search")
 cli.add_command(describe_command, name="describe")
+cli.add_command(note_command, name="note")
 
 if __name__ == "__main__":
     cli()

llm_api_scope-0.3.1/apiscope/commands/note/__init__.py

@@ -0,0 +1,2 @@
+"""Note command package for apiscope."""
+from .commands import note_command